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a product of FTG Data Systems 

^ PenDirect is the most direct link between 
you and your application — PenDirect's 
one-to-one cursor interaction means long-term 
computer use that's simple and effortless. The pen's 
precise and quick input maximizes cursor control to 
eliminate "mouse dyslexia." You'll find your natural 
hand/eye coordination beats fumbling with an 
awkward mouse any day. Light pens also eliminate 
the tedious wrist movements associated with mice 
that cause fatigue and repetitive strain injuries. 

Add pen support instantly to all your 
I applications — PenDirect works great with 

* all of your OS/2 software, with no extra 
programming or customization. PenDirect fully 
supports all OS/2 2.x, Pen for OS/2, Windows and 
DOS apps — at any screen resolution. Everything you 
need is included in the package, no special monitor 
is required, and PenDirect lets you continue to use 
your mouse. 


FREE trial offer and software — Try 

v the pen free for 30 days — after 30 days 
you may return the pen or keep it and pay just S298. No 
strings, no catches. You must be convinced PenDirect 
is the best input device for OS/2 or rurn it and owe 
nothing. 

And for a limited time, get our Pen for OS/2 driver 
absolutely free with your paid order — that's a $49 
value FREE! 

For a free 30-day evaluation unit, 
or more information, call: 





714-995-3900 


FTC 


DATA 

SYSTEMS 
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Stanton, California 90680 
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With all the hype surrounding 
business programming, one thing has 
been conspicuously absent: the facts. 


No matter how you slice it, COBOL means 
business programming. 

According to the Gartner Group 80% of all 
programmers today use COBOL. 

That’s right, COBOL. The language 
that some, shall we say, “unenlightened” 
industry pundits think has gone the way of 
punch-cards and vacuum tubes. The reality is, 
COBOL is more vital to business today than it 
ever was and at Micro Focus, we know why. 

Versatility —We’ve made COBOL the most 
“open” system in the industry. Micro Focus 
COBOL programmers can target applications 
to DOS, Windows, OS/2 and literally hun¬ 
dreds of UNIX* environments (something that 


current C, C++ and 4GLs only aspire to do). 
We’ve also added communications facilities 
and data access capabilities that make 
COBOL the ideal choice for developing 
client/server or cross-platform applications. 

Performance —We’ve made COBOL 
scream. Applications written in Micro Focus 
COBOL run as fast as anything written in C 
or C++ and faster than most 4GL-based 
applications, too. 

Productivity »—We’ve made COBOL more 
productive than C, C++ and 4GLs by adding 
advanced tools like Animator,® for streamlin¬ 
ing source code debugging as well as syntax 
extensions to handle graphical user interfaces, 


file and record locking and other important 
functions. We’ve also brought the latest devel¬ 
opment facilities like Dialog System 
Professional?' our rapid application develop¬ 
ment tool for Windows and OS/2® Revolver 
our comprehensive system-wide analysis tool, 
and even object orientation, with our Object 
COBOL Option’." 

Those are just a few reasons why program¬ 
mers insist on Micro Focus COBOL for busi¬ 
ness application development. To learn more, 
call 1-800 MF COBOL and ask for our white 
paper: “COBOL vs. C.” 

Micro Focus: The past, present and future 
of programming. 
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Watcom C/C++ V10.0 

by Watcom 

Comprehensive C and C++ development sys¬ 
tem for 32-bit DOS, Windows NT, Win 32s. 

OS/2 2.x, and Novell NLMs. and 16-bit DOS 
and Windows 3.x. Delivers productivity and 
performance, combining state-of-the-art com¬ 
piler technology with a new integrated devel¬ 
opment environment (IDE) and comprehensive 
set of tools. Includes advanced GUI debugger. 

C++ class browser, profiler, and more. 

Support for C++ templates, exception handling and Microsoft 
Foundation Class libraries (MFC). 


CA-REALIZER 

by Computer Associates 

The first truly accessible approach to creat¬ 
ing GUI applications. Using a structured 
superset of BASIC, you can quickly and 
easily create complete OS/2 and Windows 
applications without adding third party 
DLLs or learning about events, state-based 
systems, application cooperation, device 
control, and all of the other new techniques 
and complexities introduced by the other 
GUI programming systems. If you can create a program in DOS. you 
can create a program in OS/2 and Window's with CA-REALIZER! 
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Watcom VX*Rexx V2.1 

r by Watcom 

Watcom VX»Rexx is an easy to use visual devel¬ 
opment environment for creating applications that 
leverage the capabilities of OS/2 2.x and exploit Its 
CUA ’91 graphical user interface. VX*Rexx combines a project man 
agement facility, visual designer and an interactive source-level 
debugger to deliver a very approachable and highly productive visual 
development environment. With the visual designer, you can create 
an attractive graphical interface using VX»Rexx’s full suite of CUA 91 
interface objects, quickly customize their properties, and easily 
attach REXX procedures to the objects. Drag-and-drop programming 
lets you write event routines without typing any code. 


Smalltalk/V for OS/2 

by Digitalk 

Tap into the power of 32-bil technology' 
and the feature set of IBM’s OS/2 
with Smalltalk/V for OS/2, the first 100% 
pure object-oriented language for the 
Client/Server operating platforms of tomor¬ 
row. Smalltalk/V for OS/2 is a pure object- 
oriented development language that delivers 
up to twice the speed with 32-bit power, and 
gives you the portability to run on OS/2. 

Win32 or Macintosh. 

List: $995 Ours: $795 FAXcctera #: 1469-0001 



Special Introductory Price Only $99 
Client/Server Edition Only $299 


FAXccum #: 1683-0016 
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GpfREXX 

by Gpf Systems. Inc. 

WYSIWYG Visual OS/2 PM programming 
with REXX. Point and click to create PM 
design using the full CUA ’91 control 
set (e.g., NoteBooks. Containers, etc.), as 
well as Multi-Media Controls. GpfREXX 
supports standard OS/2 features like 
Drag-and-Drop and Multi-Tasking as well as the extended features, 
including: Multi-Media. SQL (DB/2 including Remote services), and 
advanced communications (APPC, CPI-C, EHLLAPI). No royalties. 
(Compatible with Gpf 2.1) 

List: $129 Ours: $119 
GpfREXX & GpfTools: List: $274 Ours: $253 

FAXreum #: 3582-0005 


PM Designer 

by Vac Nat Software 

PM Designer is a visual, extensible 
GUI toolset that makes PM develop¬ 
ment easy. Create fully functional 
multi-threaded applications with 
toolbars, status bars, multiple win¬ 
dows. and more in minutes with the 
interactive design environment. 

Visually design and test your application’s behavior, and quickly gen¬ 
erate C/C++ source code, resource. IPF. and makefiles. Extensible 
design supports any class library, compiler, or language. 

List: $99 Ours: $92 FAXcctera #: 1015-2901 
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Halo Imaging 
Library for OS/2 

by Lifeboat Publishing 

HALO Imaging Library for OS/2 enables 
you to Incorporate powerful image pro¬ 
cessing Into your applications with over 
100 C/C++ imaging functions. This 
advanced toolkit provides a full range of 

functionality Including the ability to display, enhance, print, manipu¬ 
late. and save most popular digital image formats. Special effects 
such as sharpen, blur. warp, color conversion, scaling, and more are 

also Included. 
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BY DICK CONKLIN 


■ n Editors 
Comments 


Gary Kildall , CP/M 
and OS/2 


r his summer we lost a pioneer in PC operat¬ 
ing systems. Digital Research founder Gary 
Kildall. I was privileged to work briefly with 
Gary back in 1980, when I joined IBM's PC devel¬ 
opment team. At the time, I was running Gary's 
CP/M operating system on my Apple II comput¬ 
er. CP/M was the king of the hill back then, the 
industry standard in desktop operating systems. 
DOS existed only as SCP 86-DOS, a CP/M-like 
clone developed for the new 8086/8088 16-bit 
processors by Seattle Computer Products. 

Most people assumed that CP/M would be the 
operating system of choice for the new IBM PC. 
Almost nobody had heard of DOS. Of course, 
existing CP/M applications would still have to be 
updated and recompiled for the PC's new proces¬ 
sor, no matter which operating system was used. 

Gary liked to call himself a hacker and pre¬ 
ferred to leave the marketing and legal concerns to 
his staff. Scheduling and contractual problems 
caused a snag in the negotiations, and tiny 
Microsoft, led by a young and aggressive Bill 
Gates, seized the opportunity. SCP 86-DOS was 
quickly acquired, and work began on porting 
early applications like VisiCalc and Easy Writer to 
the new machine. CP/M-86 arrived on the scene 
several months later, but it was too late. 

Today, OS/2 developers face an exciting 


future. The PowerPC chip and symmetrical mul¬ 
tiprocessing (SMP) are driving hardware technol¬ 
ogy forward, while D50M, Taligent, 
and OpenDoc are doing the same for 
software. Only OS/2 is so well posi¬ 
tioned to take advantage of the 
future, and OS/2 applications will 
lead the way. 

Gary Kildall was a great pro¬ 
grammer and pioneer, but he will 
always be remembered for that one 
giant missed opportunity. We will 
miss him. 
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GUIComer 

In this issues column, we continue our discussion of a 32-bit replacement list box. This time we'll show 
you how to write a C++ wrapper for the 32-bit list box and integrate it into the IBM C Set++ User 
Interface Class Library. By MARK BENGE and MATT SMITH 


Object of Desire 




Mntt Smith 


mm s we continue our journey in 
MM writing a 32-bit replacement list 
M I box, we would like to examine 
an area of particular interest to many, to 
which this issue is dedicated: object-ori¬ 
ented programming. We will develop a 
C++ class, listBox32, which is a wrapper 
of the 32-bit list box control. We will de¬ 
sign ListBox32 for integration into the 
IBM C Set++ User Interface Class 
Library (ICLU1). 

Although hints are provided, the C 
Set++ documentation is incomplete con¬ 
cerning the design and implementation 
of a custom control using the C Set++ 
ICLUL We will code ListBox32 and docu¬ 
ment key areas in this article that will 
show you not only how to design and 
implement a C++ custom control but 
also how to replace the underlying 
Presentation Manager control and in¬ 
herit its support and functionality from 
ICLUI, all without using the "hairball" 
treatment (if you're a cat owner, you 
know what we mean)! 

The 32-bit list box is a custom control 
that can be used as a replacement for the 
Presentation Manager list box. Since it is 
a replacement and not a new control, 
wrappering it presents a few challenges 
we'll show you how to overcome. The 
following sections describe the steps re¬ 
quired to design and code LislBox32. 


TO SUBCLASS OR TO 
WRITE FROM SCRATCH? 

The C Set++ list box class, IListBox, is a 
wrapper for the Presentation Manager 
list box control* Although we have 
added extensions to the 32-bit list box, 
many of the member functions within 
IListBox can be reused without any mod¬ 
ifications. Writing from scratch means 
reimplementing everything. Guess 
what? Yes, you guessed it: we're lazy, so 
we're taking the path of least resistance. 
However, this approach does present 
some other hurdles, which we'll show 
you how to clear. Therefore, our task is 
to show you the necessary steps to cre¬ 
ate a subclass of IListBox, which we'll de¬ 
note as Li$tBox32, We will design our 
subclass to accommodate a snug fit with 
the ICLUI hierarchy. 

SO YOU WANTED TO BE IN 
CONSTRUCTION? 

Before building the ListBox32 object, we 
need to satisfy the underlying 
Presentation Manager requirements— 
remember, IListBox uses the tfC_LISTB0X 
predefined window class when creating 
the underlying Presentation Manager 
window, whereas we will be using the 
"ListBoxWindow 11 private window class. To 
satisfy the Presentation Manager re¬ 
quirements, we have defined a static 
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The eagle 

has landed... 


on "planet OS/2". Introducing PREDITOR/2. 


Your source code has never fallen prey to a more powerful editor. PREDITOR/2 is for developers 
who don’t have the time to deal with rigid programming environments, who must change facilities 
to fit their exact requirements and who need to dramatically extend editing functions to attain 
peak productivity. This editor stalks code with the speed and versatility of a true predator* 


HIGHLIGHTS; 

• CUA-compliant GUI 

• Multiple document interface 

• BRIEF. VI, EMACS, ISPF. CUA emulation 

• WorkFrame/2 integration 


Bull i-in compiler support 


• Extensive customization facilities 

• Powerful C-like extension language 

• Unlimited Undo and Redo 

• Powerful search and replace functions 

• No limits on file sizes, buffers or windows 


Special Introductory Price... $149.00 * MSRP $249.00 
To order PREDITOR/2 or to receive a brochure, call now. 1 -800-539-8707 or fox:1-810-737-7119 


PREDITOR/2 is a trademark of Compuware Corporation, All other company 
Or product nemos are trademarks of their respective owners. 

© 1994 Compuware Corporation 
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Tales from the Trenches 
(Building C++ DLLS) 

In C, exported names are the same as the functions they represent. 
However, in C++ the names of the external references are mangled to 
support function overloading. What this all boils down to is more work 
to generate a DLL. 

Two methods can be employed to generate C++ DLLs: 

• Use of .Export or the tpragma export in the source code 

• CPPFILT, which is the .DEF file building tool. 

We chose to use the second method to generate XLISTBOX.DLL. We 
filed a number of required steps to generate the DLL: 

1. Compile all of the modules with the /Ge- option. 

2. Run the CPPFILT utility on all the .OBJ files using the -b -p 
options, redirecting the output to a .DEF file. 

3. Prefix the .DEF file with the following statements: 

LIBRARY XLISTBOX INITINSTANCE TERMINSTANCE 

DESCRIPTION 'C++ Wrapper for 32-Bit Replacement Listbox' 

PROTHODE 

DATA MULTIPLE NONSHARED READWRITE LOADONCALL 

CODE LOADONCALL 

EXPORTS 

4. Link the DLL. 

5. Create the import library. 

Those of you who are familiar with this method will notice that we 
skipped the tempinc steps and the editing step to exclude undesirable 
symbols. The tempinc steps were skipped because a tempinc subdirec¬ 
tory does not exist. Also, we're lazy, so we're giving you all of the sym¬ 
bols CPPFILT generates, including the kitchen sink. 

Building a C++ DLL can quickly become a monotonous chore that C++ 
developers have to do over, and over, and over, and over again. Our rec¬ 
ommendation is that this process be automated and that the automa¬ 
tion take place in the IBM WorkFrame/2 product. 


function named createListBox. Why 
static? We haven't constructed the 
ListBox32 object yet, so we must 
use a static public function that 
we defined within the scope of 
ListBox32 that can be called prior 
to construction of the object. 
Figure 1 shows the definition of 
the List8ox32:rcreateListBox func¬ 
tion. Note how we intermix C and 


C++ code in this routine to create 
the list box, and note the provision 
for extended styles. Lest we forget, 
the registration of our window 
class, "ListBox Window", occurs here, 
which essentially makes it a pri¬ 
vate class. If you would like to 
make it a public class, see the side- 
bar "Unraveling the Great 
SYS_DLLS-OS2.INI File Mystery 


in An Object of Many Colors: 
Using Custom Controls Within A 
Workplace Object article," (No¬ 
vember/December 1993). 

Once we have created the 32- 
bit list box control, we can con¬ 
struct the ListBox32 object. Since 
ListBox32 is a subclass of IListBox, 
we need to derive from IListBox in 
our List8ox32 constructors. In the 
derivation, we pass the window 
handle, IWindovHandle, returned by 
WinCreateVindow to the IListBox con¬ 
structor that takes the window 
handle of an existing list box con¬ 
trol. After construction, we can tap 
into the existing public and pro¬ 
tected IListBox member functions 
via inheritance. Consequently, a 
nice side effect of this operation is 
that we convince the IListBox mem¬ 
ber functions that they are still pro¬ 
cessing a WC.LISTBOX-based list box 
instead of ours. 

Before we discuss extended 
styles, let's examine the construc¬ 
tors we have provided. In the pre¬ 
ceding paragraph, we discussed 
the constructor that takes many of 
the arguments you would nor¬ 
mally pass to the WinCreateWindov 
API. As illustrated in the source, 
these arguments are exposed using 
ICLUI nomenclature. 

A second type of constructor 
supports dialogue templates. It ac¬ 
cepts as arguments a parent win¬ 
dow pointer for the dialogue and a 
control identifier of the 32-bit list 
box control. The last type of con¬ 
structor accepts the handle of an 
existing Presentation Manager 
window. These constructors have 
special requirements. The two pri¬ 
mary ones are that the input win¬ 
dow must be validated (that is, it 
must exist), and the window class, 
"ListBoxVindotT, must be verified for 
the input window. Those of you 
who are familiar with ICLUI de¬ 
sign will recognize that these three 
constructors are consistent with 
those provided with the controls 
ICLUI supports. 
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PRESTO! A PRACTICAL 
CLIENT/SERVER SOLUTION! 


Introducing GLS-Presto 2.0. 

Now you can build state of the art OS/2 and Windows 
applications for hundreds and even thousands less. 

Presto is the only client-server development tool which 
generates OS/2 and Windows applications in COBOL, C 
and C++, for one low price* 

Presto is designed to help you become a client/server 
magician as quickly as possible without compromising on 
power, flexibility and security. 

With Presto there is no need to invest in proprietary technol¬ 
ogy or suffer through an extensive learning curve. Presto 
allows you to take advantage of COBOL, C, C++ and SQL 
while effectively isolating you from the complexities of 
client/server development* 


RIb Options Toots Hetp 

ProJact Object List 
0 lf= ~^ Security Management Systems 

—© Employes Database 

—0 |jH) Ph 



Presto's intuitive, easy to use integrated development 
environment will have you performing client/server tricks in 
no time at all. Design, prototype, generate, test and debug 
without ever leaving the IDE* 

Presto makes the difference between OS/2 and Windows 
disappear, and lets you take advantage of the best of what 
they have to offer. For example, Windows MDI support is 
included for OS/2 and OS/2 control types may be used 
within Windows. Simply define your application* then 
select the target environment when you are ready to gener¬ 
ate. Presto does the rest. 



* Create complex applications in a minimum of time and 
run them under OS/2 and Windows. 

* No knowledge of GUI or SQL programming required. 
The Presto code assistants are always ready to serve * 

* Supports RAD methodology with instant proto typing. 

* Generated applications are quick and compact. 

* Works with all major COBOL, C and C++ compilers. 

* Incredibly fast. Applications generate in seconds. 

* No compromises. MDI f tool bars , status bars t window 
geometry, custom controls and more * 

■ Use any DBMS or file access method compatible with 

your compiler. 

* Fully networkable. No cumbersome object management 
required. 

* Multi-media capability built in. Display GIF, TIF and 
Bitmap images dynamically. 

* A bsolutely no royalties or run-time fees. 

Presto can appear on your computer for only 



There is no better value. 


To make some magic of your own, give us a call now at 
(219) 481-5809. Or, place an order via CompuServe, our 
mailbox is 73762,114, 


Great Lakes Software Inc. * 810 E. Coliseum Blvd Suite 109 * Fort Wayne* IN 46805 * Phone 219-481-5809 * Fax 215M83-8301 

© Great Lakes .Software [tic. All rights reserved. Prices and specificai low maj change without notice. All products named are trademarks of their respective companies. 
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/* - -—- - --*-—— 

I ListBox32::ListBox32 

I 

I Static function that creates the 32-Bit list box* 


IWindoyHandle ListBox32::createListBox32(unsigned long uHd P 

lyindow apparent, 

Window *pQvner, 

const IRectangLe ftrectlnit, 
const Style ftstyle. 


--*/ 


{ 


const ExtendedStyle &extendedStyle) 

/* Assertions on input parms */ 

/**************+***+****+***+***+***+**+**+****+****************/ 

IASSERTPARNCpParent!=0); 

/***************************************************************/ 

/* Register the 32-Bit list box class */ 

if (!fRegisterListBox( IThread:scurrentQ.anchorBlockO )) 

ITHRDWGUIERRORf "fRegisterlistBox" ); 

/***********:M*t******t4****MM*M*MM****ttM****************/ 
fa Build the control data structure for the 32-Bit list box */ 
/*#*M********MM****MM+*************:M**********************/ 

LISTBQXCDATA ctlData; 

memsetC&ctlData, 0 f sizeof(LISTBDXCDATA)); 
ctlData.cb = sizeof(LISTBQXCDATA); 
ctlData.ulVersion - LBV^llO; 

ctlData.vdata.lbcdl.1,flExtStyles = extendedStyle■asUnsignedlong{); 

/*****«***********************************♦********************/ 
fa Create the 32-Bit list box */ 

WindoyHandle hwndLB = VinCreateWindow( pParent->handle(), 

"ListBoxWindow", 

0, 

style. asUnsignedlongO, 
rectlnit.leftO, 
rectInit.botto»{), 
rectlnit.width(), 
rectlnit.height(), 

(pQwner==0) ? IWindoyHandle(0) : 
pOyner->handle() f 

MMD.TOP, 

ulld, 

fectlData, 

0 ); 

if (hwndLB = 0) 

{ 

HHROyGUIERRORdStringCWinCreateyindow: Id*") + 

IString(ulId) + 

XStringC" Qass=ListBoxYindov")); 

return{ hwndLB ); 


Figure l ListBox32;:createListBox function 
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* Easily bind objects directly to your database 

* Quickly connect to your database 

• Visually generate and test your SQL query 
Rapidly create more than a dozen chart types with 

over 150 display options 


PLUS 

All of the Powerful Features 
i of the Mew VX'Rexx > 


Watcom VX'Rexx is an award winning, 

easy to use visual development environment 
for creating OS/2 applications with rich 
graphical user interfaces, VX'REXX 
combines a project management facility, 
visual designer and an interactive source-level 
debugger to deliver a very approachable and highly 
productive visual development environment. 

Design Applications Visually 

Create rich graphical applications quickly and 
easily using the visual design environment, With 
the visual designer, you can graphically create 
CUA’91 Presentation Manager interface objects, 
quickly customize their properties, and easily attach 
REXX procedures using powerful drag-and-drop 
programming techniques. 

integrated Development 

Environment Build, test and debug your 

application without leaving the development 
environment. Then package your application as an 
EXE file or PM macro for royalty-free redistribution. 
The power of the integrated development environ¬ 
ment and debugger can also be used with your 
existing REXX applications. 

Powerful Open Environment 

Enjoy the simplicity of event-driven programming 
together mih the global editing capabilities 
essential for professional project management. 
Watcom VX'Rexx is open and extensible through 
IBM’s object-oriented System Object Model 
(SOM) technology* You can access all standard 
REXX API’s including DB2/2, because VX-REXX 
is based on the OS/2 2>x standard 
system REXX. 


verslon2 -' 'mm 

VERSION 0.1 


• Over 2 dozen objects, including GUA'91 Containers, 
Notebooks, Pop-up Menus and more 

• Integration and control ol existing applications 
through DOE, keystrokes or REXX API s 

• Easy to learn event-driven programming model with 
complete on-line documentation 

•Context-sensitive help 

• Powerful drag-and-drop programming techniques 
simplify programming 

• Develop professional multi-threaded, multi-windowed 
and drag-and-drop enabled applications 

• Code reusability through section sharing 

• Include OS/2 style help and hints in your applications 

• Advanced interactive source-level debugger 

• System Object Model (SOM) based object manager 

• Package your application as an EXE or PM macro for 
royalty-free distribution 

• Integrated console window support simplifies 
migration of existing REXX programs 


Experts Agree../ 

for development is like driving a Porsche: 
it's fast, it’s compact, everything in the 
right place , and it makes us look good, too ” 
Peter Coffee, PC WEEK, May 2,1994, 

“(VX*Rexx) applications can be multithreaded 
and REXX is probably the easiest language in 
which to learn the OS/2 thread model” 

Software Development, November, 1993. 

“VX'Rexx is a great tool; if s fun and productive” 
PC Techniques, Dec/Jan. 1994, 
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Watcom VX*Rexx 


Version 2.1. Special Price $99 

Client/Server Edition. Special Price $299 

1 - 800 - 265-4555 

Watcom 

A Powersoft Company 


Watcom International 415 Phillip Street. Waterloo, Ontario, Canada. N2L 3X2 Phone: (519) 8E6-370Q Faxi (519) 747-4971 
^Prices and specification are subject to change without notice. Price does not include freight arid taxes where applicable. Prices quoted in US dollars. 
Watcom, the Lightning Device, and VX-Revi arc trademarks of Wucota Internationa] Corporation. Other trademarks are the properties of their 
respective owners. ^Copyright Watcom International Corporation. 
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STYLISH EXTENSIONS 

In "A Musical List Box" (May/ 
June 1994), we discussed extended 
styles and exposed the interface 
through the control data structure. 
Why? Basically, we ran out of bits 
in the base Presentation Manager 
style interface. C Set++ ICLUI pro¬ 
vides a nested bit flag definition 
class that is used to provide a C++ 
object-oriented interface to the 
Presentation Manager styles. Since 
we are subclassing IListBox, we in¬ 
herit the definitions and support 
for IListBox::Style. Therefore, we 
need to concern ourselves only 
with providing support for the ex¬ 
tended styles. 

We have defined a nested bit 
flag definition class, ExtendedStyle, 
which we will use to support our 
check box extended style. As we 
add new extended styles, we can 
easily add support for those to the 
ListBox32 class, based upon the cur¬ 
rent extended style framework. 
Since we are using the control data 
structure interface to pass the ex¬ 
tended styles to the 32-bit list box 
(shown in the module driver.c that 
was part of the lstbx2.exe source 


code package for the May/June 
1994 issue), we will continue to use 
that interface, as illustrated in the 
code in Figure 1. 

We simply obtain an unsigned 
long representation of the ex¬ 
tended style and store it in the 
flExtStyles field of the control data 
structure before passing it to 
WinCreateVindov. 

IT'S IN THE MAIL 

Control notifications are processed 
as part of the WM.CONTROL message. 
The function dispatchHandlerEvent in 
our handler class, ListBox32Handler, 
looks much like a WM.CONTROL case 
statement you would encounter in 
a window proc written in C. As 
shown in the source, you still need 
to verify the window class, as noti¬ 
fication IDs overlap between con¬ 
trols, and you need to look for no¬ 
tifications of interest. The primary 
difference between C and an 
ICLUI implementation is that 
ICLUI encapsulates the notification 
via a virtual function that may be 
overridden in a handler subclass to 
provide the required behavior. 
Therefore, when you would like to 


receive your mail, er notification, 
you would simply override the 
function, which is still less expen¬ 
sive than purchasing a stamp! 

TOO HOT TO HANDLE 

C++ handlers in ICLUI are similar 
to window subclass procedures in 
C. Window subclass procedures 
are typically one large switch and 
case block with individual case 
statements for messages whose de¬ 
fault behavior is overridden. 
ICLUI encapsulates messages as 
events and isolates the processing 
of an event or related events in a 
handler, such as the keyboard han¬ 
dler, IKeyboardHandler. Virtual han¬ 
dler functions are then provided to 
expose elements of the event that 
may be overridden to alter the de¬ 
fault processing. Figure 2 is a sim¬ 
ple illustration of the message and 
event flow within a traditional C 
application and an ICLUI applica¬ 
tion, respectively. However, this 
figure is not concise, as we are try¬ 
ing to limit our discussion to the 
essentials. 

Let's back up a little and look 
at the notification events that 


Typical ICLUI 

C Architecture Architecture 




Figure 2. C vs. ICLUI event flow 
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Now, all the C/C++ development tools 
you need come in one handy package. 
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Bonus Bundle: C Set ++ CD-ROM, OS/2 for Windows, 
KASE:Set and Experience C++...just $249 ! 


IBM CSet++™ Version 2.1 is 
the most comprehensive C/C++ 
development package you can 
buy for OS/2*. Period. 

C Set ++ can dramatically slash 
your programming time with 
an intuitive graphical interface 
and world-class optimization. 

Your applications are quick to 
build, fast to execute and easier 
than ever to modify. 

C Set ++ brings you the most 
complete set of class libraries 
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ICLUI handles on the behalf of 
IListSox. Virtual selection and enter 
functions are defined within the 
ISelectHandler class. Also, virtual 
focus gain and loss functions are 
defined in IFocusHandler. None of 
these functions perform any pro¬ 
cessing, as process definition is to¬ 
tally in the hands of the applica¬ 
tion developer, through functional 
overrides, to supply the desired 


check 

checklU 

unCheek 

unChecklll 

isChecked 

numberChecked 

thee kedl tern 


Figure 3, Check-state operation functions 


behavior. However, both handlers 
are tightly coupled to the Pre¬ 
sentation Manager control suite 
through use of the predefined win¬ 
dow classes. Therefore, we must 
write our own handler since both 
handlers process events based on 
the VC_LISTBOX window class, 

Li$tBox32Handler is designed to 
spy out all of the WH.CONTROL notifi¬ 
cation events of interest and pro¬ 
vide a corresponding virtual func¬ 
tion. Four functions implemented 
were mentioned in the preceding 
paragraph. We have defined two 
more, checked, which supports the 
check box extension, and scroll, 
which supports scrolling. When* 
ever a check box is checked or 
unchecked, the checked function is 
called, and whenever scrolling oc¬ 
curs, scroll is called. Again, by de¬ 
fault these functions do not do 


anything, as you will need to de¬ 
rive from ListBox32Handler and over¬ 
ride the specific functions to obtain 
the desired effect. Since integration 
with ICLUI is one of our goals, we 
have designed ListBox32Kandler to 
give it the same look and feel as 
the predefined handlers. 

ONE SIZE FITS ALL 

ICLUI canvas classes have a spe¬ 
cial requirement that it places on 
its child controls: knowledge con¬ 
cerning the minimum size of the 
controls. The minimum size can be 
communicated to the canvas 
classes in one of two ways: over¬ 
riding the protected virtual mem¬ 
ber function, calcMinimurnSize, or ex¬ 
plicitly calling the function, 
setHinimumSize. The ealcMinimumSize 
function returns an ISize object, 
which is, by default, ISize (100 *100), 
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Additionally, it will not be called if 
the size has been set via the 
setftinijnuntSize function. 

Although the IListBox class 
does not override calcMinimumSize, 
we would like to make the 
List8ox32 class as robust as possible. 
Therefore, we will override it and 
supply the minimum required 
width based upon the longest item 
in the list box and the current font, 
if the horizontal scrolling style is 
not used. We will use the default 
for the minimum height, 

MEMBERSHIP INCLUDED 

We have added several new mem¬ 
ber functions to support our check 
box and sound extensions in 
ListBox32. We would like to concen¬ 
trate on those functions that were 
implemented to support the check- 
state operations and compare and 


contrast them to the IListBox selec¬ 
tion-state operation functions. The 
check-state operation functions im¬ 
plement support for the extended 
messages, LHX_QUERKHECK and 
LU.SETCHECK. 

The check-state operation 
functions are listed in Figure 3. All 
have been designed to closely par¬ 
allel the IListBox member functions 
for the select ion-state operations, 
lest we forget our premise of a 
snug fit with the ICLUI hierarchy. 
However, we have defined our 
functions to be virtual. Why? To fa¬ 
cilitate subclassing of ListBox32 and 
allow an application developer to 
replace or enhance a function to 
achieve the desired behavior. 
Functions in IListBox are not vir¬ 
tual; altering behavior will require 
extra work as well as deviance 
from standard C++ design. This is 


a design issue that will be ad¬ 
dressed in a future release of 
ICLUI. 



CONCLUSION 

The article text is based on our ef¬ 
forts to design and implement the 
various classes that wrapper the 
32-bit replacement list box. The de¬ 
sign and techniques we discuss are 
applicable to wrappering other re¬ 
placement controls. You can obtain 
the source code from the locations 
listed at the end of this article. In 
addition to the source for the 
classes, we have provided a driver 
application. In the next issue, we 
will enable text editing in the re¬ 
placement list box. 

We would like to thank Bill 
Law and Hiroshi Tsuji for answer¬ 
ing a lot of our questions and giv¬ 
ing us a sneak preview of the book. 
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OS/2 V2 C++ Class Library: Power 
GUI Programming with C Set++ 
(forthcoming from Van Nostrand 
Reinhold), which they and three 
other members of the 1CLUI team 
have authored. 

Mark Benge, IBM Software Solutions, 
Cary, N. C., is a staff programmer who 
joined IBM in 1989 and has worked on 
various CUA '91 controls for OS/2 2.x. He 
works in IBM user interface class library 
development, where he was involved in 
the implementation of C++ classes for 
drag and drop in C Sef++ 2.1 Benge has a 
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OS/2 Tools section on the 
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B.S. in computer science from Western 
Carolina University. He can be reached on 
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from the University of Waterloo. He can be 
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Even in a world where they had lost some control of their data, the people at Parkway Insurance found 
OS/2 still had ways to provide what they needed. By BRIAN PROFFIT 


Life After Outsourcing 



Brian Proffit 


I Jl^hen Parkway Insurance 
I# I# shifted its data processing to 
W W an outside company, the 
MIS department found a lot of local 
development was still needed. 

As corporations look for new ways 
to trim their overhead, many are decid¬ 
ing to hire outside companies to handle 
a large part of their data processing 
needs. Internal MIS organizations find 
their staff decimated while demands 
from users continue to pour in. Harried 
data processing personnel find them¬ 
selves in the middle of several enclosing 
jaws. 

The outsourcing company is usually 
focused completely on the mainframe 
processing requirements. Prices for local 
workstation development projects can 
be steep, and even then the project is not 
likely to be high on the vendor's priority 
list. In many cases, their developers' 
experience level in the workstation envi¬ 
ronment is not ideal. 

But the vendors hold the trump 
card—they control the data. Client/ 
server processing is really the only 
answer. Parkway Insurance required 
simultaneous access to (but not control 
over) four host databases and tools that 
could provide quick development of 
programs to automate these processes. It 
found an OS/2 network to be the only 
acceptable solution. 


HOST PROCESSING 
FRAGMENTED AND SLOW 

Parkway is a subsidiary of Fireman's 
Fund of New Jersey, and the company 
focuses entirely on personal automobile 
insurance for that state. Parkway takes 
customer service seriously, with a group 
of operators on 800 numbers to answer 
customer questions. 

When they were entirely host-based, 
those operators faced a rather daunting 
challenge. The information is spread 
over four separate databases, so cus¬ 
tomers had to wait while operators 
queried each database for bits of the 
required data. Since each database is 
keyed on a policy number, operators 
had to reenter that number four times— 
with four opportunities to wait for a 
host response to tell them they'd entered 
the number incorrectly. Worse still, the 
operators, in an effort to save time, 
sometimes skipped the step of writing 
the policy number down. Unfortunately, 
they frequently ended up having to ask 
the customers to repeat the number. 
This is the sort of problem that led 
Parkway to a client/server solution. 

3270S OUT, VALUEPOINTS IN 

Brian Howson, MIS programmer and 
analyst, reports that nearly 60 new 
workstations have been rolled in to 
replace the old 3270 terminals. They 
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standardized on IBM Valuepoint sys¬ 
tems with 16MB of RAM. Most are run¬ 
ning at 800x600x256. Connecting all of 
these machines is a token ring network 
based on LAN Server 3.01. The server is 
a PS/2 model 95 with 32MB of RAM 
and 1.5GB of disk space. Four Hewlett- 
Packard printers are also on the net¬ 
work, connected directly via JetDirect 
token ring interfaces. Key to bringing all 
the data processing needs together is a 
3174 controller with a token ring gate¬ 
way to connect the network with the 
mainframe. 

CONNECTING TO THE HOST 

Because that mainframe connectivity is 
so important—all the mission-critical 
applications are still on the host—selec¬ 
tion of the 3270 emulation software was 
a critical decision. "I evaluated 
Attachmate's Extra and IBM's 
Communications Manager at the same 
time/' Howson reports. "I found Extra 
to be significantly easier. For example, 
we have DLC connections. The only 
thing I have to tell Extra is that it is DLC 
and give it the destination address. It 
makes the connection automatically, and 
I can get sessions up very quickly." 

Of course, any decision this impor¬ 
tant can't be made on the product alone. 
If you're gambling the success of your 
business, you have to feel good about 
the vendor. Parkway has a customer 
support agreement with Attachmate 
that Howson would like to see other 
vendors emulate. 

"Our customer support agreement 
costs $1,500 per year for the whole site, 
which is over 50 licenses," Howson 
says. "That entitles us to single-point-of- 
contact support. That's sort of like what 
IBM is starting for OS/2. We get a report 
on our usage every month, also like 
what IBM is starting for OS/2. We also 
get free upgrades, which is not like what 
IBM is offering for OS/2." 


Howson also praises the flexibility 
of the agreement, reporting that they 
"have the ability to switch users' 
licenses from Windows to OS/2. We can 
upgrade or change the licenses at will." 

Of course, the right to free upgrades 
is only meaningful if those upgrades are 
released regularly and provide solu¬ 
tions. "They just shipped an upgrade a 
couple of weeks ago that fixed a lot of 
things missing from earlier Extra ver¬ 
sions," Howson reports. "They added 
support for the network gateway and 
added a keyboard mapper as well as 
fixed a few things that had been bother¬ 
ing us. The program right now is a 
Mirrors port, so there are some screen 
flickers and it's sort of slow. In fact, it 
slows things like our billing inquiry pro¬ 
gram down. 

"Those things will be much faster 
when they port it," Howson says hope¬ 
fully. "Right now they're telling me that 
they should be fully 32-bit OS/2 by the 
end of 1994. The product manager also 
told me that they're going to support 
Workplace OS/2." 

CUSTOMER SERVICE FASTER AND EASIER 

After the hardware and software were 
in place, Howson attacked the host data¬ 
base lookup problems the customer ser¬ 
vice operators were facing. The first step 
was acquiring a graphic toolkit from 
Attachmate for accessing Extra sessions, 
and the second step was pulling it all 
together with Watcom's VX-REXX. 

Howson says, "Billing Buddy [the 
new customer billing information 
inquiry system] is a good example of 
how an inexpensive tool like VX-REXX 
can exploit the standard scripting 
[REXX] capabilities of OS/2 to add func¬ 
tionality to a legacy mainframe applica¬ 
tion quickly and effectively. From the 
time I got the graphic toolkit for Extra 
until the application was deployed was 
under two weeks. That included gather- 
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ing heavy end-user input which 
led to very good acceptance." 

The application takes the pol¬ 
icy number (which now only has 
to be entered once) and perforins 
the host database queries automat¬ 
ically—doing so across three sepa¬ 
rate mainframe terminal sessions 


simultaneously. The results are 
presented in a Workplace Shell 
notebook. Howson exploits VX- 
REXX's ability to create multi¬ 
threaded programs for responsive¬ 
ness. "Even though it takes 30 
seconds to get all the information, 
the interface is active all the time/' 
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he says. "They can begin looking 
at and paging through the infor¬ 
mation as soon as the first results 
are loaded into the notebook. That 
lets them concentrate on taking 
care of the customer on the phone 
instead of fiddling with the com¬ 
puter. It improves customer service 
and speeds up calls." 

VX-REXX BRINGS IT ALL TOGETHER 

Billing Buddy is not just faster, it 
provides the users with new capa¬ 
bilities. For example. Parkway is 
using cc:Mail as its internal mes¬ 
saging system. If a customer 
inquiry generates a work item or 
information request, the operator 
can click on a button in the billing 
system and open a cc:Mail mes¬ 
sage creation screen. As with 
Extra, Howson was just as careful 
in the selection of (and is just as 
high in the praise of) the develop¬ 
ment tool to use for these new 
client/server applications. 

"I think Watcom is one of the 
best companies I've ever dealt with 
as far as upgrades and support," 
Howson says. "Watcom VX-REXX 
is about the best-designed tool I've 
ever seen. It's very intuitive. After 
you've used it for a while, you 
really don't have to look at the 
manual much because you can 
guess what they did and where 
they were going. You're usually 
right because they did exactly 
what you would expect. It's very 
consistent." Howson is anxiously 
awaiting the new Client/Server 
Kit from Watcom to eliminate a lot 
of convoluted SQL statements and 
ease access to the DB2 database. 

Howson found Billing Buddy 
to be a perfect application for VX- 
REXX. "I can't even imagine how 
long it would have taken in C/' he 
says. "It would have been an awful 
lot longer. And because this is an 
application that is tied to main¬ 
frame performance, writing it in C 
rather than REXX would have 
given us virtually no advantage. It 
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wouldn't run any faster, at least 
not appreciably. And the whole 
program is less than 1,300 lines of 
code in REXX." 

IF YOU CAN'T SQL IT f SCRAPE IT 

Much of the local processing 
Parkway does is based on the 
DB2/2 server on the network. 
Since the data is owned by the 
host, the company often creates 
temporary databases on the LAN 
for immediate needs, knowing that 
these will need to be recreated 
nearly continuously, VX-REXX 
Client/Server will help with some 
host database queries, but the 
users are also forced to do some 
"screen scraping/' 

This technique uses existing 
host programs to bring the desired 
information to the screen. A work¬ 
station program then extracts it 
from the display for reuse. It's a lit¬ 
tle less elegant, perhaps, but it can 
be a lot easier and less expensive 
than contracting with the outside 
data processing vendor to create 
new host code. Parkway is using 
this technique to help streamline 
its forms processing. 

Previously, most of the compa¬ 
ny's forms were still being filled 
out by hand and taken to a clerk 
for typing. Parkway Automated 
Forms is querying the host for rela¬ 
tively stable information like insur¬ 
ance agents' addresses and scrap¬ 
ing information from mainframe 
screens for data that cannot be 
effectively replicated. Howson esti¬ 
mates that the time and labor 
required to generate a form will be 
cut to one-sixth of the prior effort. 

WHAT MORE COULD 
YOU POSSIBLY NEED? 

For reference material on OS/2 
development, Howson relies on 
IBM's OS/2 Developer Connection 
CD-ROM. "It has helped me a lot 
as a source of information. One of 
the best parts is that the on-line 
books are on there also. I think that 


on-line books being included in all 
of the individual products is pretty 
much going to die and be replaced 
by collections like this. The docu¬ 
mentation on the CD is really 
good, and some of the examples 
there are helpful too. Basically, I 
use every resource I can get/' 


Parkway has a CD-ROM drive 
on its server, but the single drive 
can be a bit of a bottleneck for the 
developers. "It [the single drive] 
causes some contention. We also 
use the Westlaw database on CD, It 
keeps us up to date on New Jersey 
statutes. This is important because 
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we're in a very litigious state, and 
we have people quoting statutes at 
us all day in terms of personal auto 
insurance. So we have that on line 
nearly all the time." Howson is 
considering a CD jukebox for the 
network to allow access to several 
CDs simultaneously. 

EXCLUSIVITY BRING REWARDS 

Parkway has standardized on 
Lotus SmartSuite for its office 
automation functions—primarily 
because it is the only real OS/2 
suite available, and the benefits of 
standardization are large. "I still 
have some users stuck on the DOS 
versions of 1-2-3 and Word¬ 
Perfect," Howson says. "We're try¬ 
ing to move people to Ami Pro. I 
looked at WordPerfect 5.2 for 
OS/2, and it was really bad. The 
5.2A update was a lot better, but 
by then I had pretty much given 
up on WordPerfect, and they had 
given up on us too, I think." 

Howson hopes that Lotus 
Development Corp. doesn't be¬ 
come complacent without compe¬ 


tition in the OS/2 market. "We just 
got our updated versions of 1-2-3 
and Freelance Graphics, but there 
wasn't much there. Installation is 
improved—it's faster, more 
friendly, and prettier. I had to make 
a lot of noise just to find out about 
it too. When I was trying to get this 
upgrade, I could not get any help. I 
ended up talking to their PR firm, 
and I finally got a call from their 
product manager! It was hard to 
get information from them." 

SHAPES IN THE CRYSTAL BALL 

Now that the OS/2 network is in 
place. Parkway plans to exploit it 
further by tying the users together 
into a groupware scheduling sys¬ 
tem. Right now, IBM's Time and 
Place/2 is the leading contender 
for this function. 

Howson also plans to improve 
communications with Parkway's 
vendors by establishing an Internet 
gateway with the company's 
cc:Mail system. "We plan on set¬ 
ting up an Internet connection 
through PSI (an Internet provider). 


and we're going to set up the uucp 
link so we can send mail to anyone 
on the Internet. With PSI, we can 
get unlimited Internet mail for the 
entire office for $50 per month. 
And we can use cc:Link to connect 
the Internet mail to cc:Mail." 

In this gateway, though, 
Howson finds another chink in the 
Lotus armor. Despite the compa¬ 
ny's statements of support for 
OS/2, it appears that not all prod¬ 
ucts are included. Not only is there 
no OS/2 version of cc:Link, but 
Howson reports that he has been 
unable to coerce it into working in 
a DOS session under OS/2. For its 
part, Lotus has simply told him 
that it isn't supported under OS/2, 
so Howson is being forced to use a 
dedicated DOS machine for the 
Internet gateway. 

SO WHY OS/2? 

Accessing multiple host sessions 
and a LAN database simultane¬ 
ously led Parkway to the conclu¬ 
sion that there was no reasonable 
alternative to OS/2. "I saw after the 
release of version 2.0 and particu¬ 
larly 2.1 that OS/2 can do the job 
that other vendors are only now 
promising," Howson observes. "I 
need to balance an environment 
between richness of function and 
the amount of support it requires. I 
have found that with OS/2, I can 
give the users all of the function 
they need, and I can support the 
whole network and still run reports 
and develop applications." 

Brian ProHit was part of IBM Corp.'s 
OS/2 development team before leaving to 
become director of PC Week Corporate 
tabs. Prof fit is currently president of 
Visionary Research, an independent con¬ 
sulting firm. He also is the author of two 
books on OS/2. Proffit is a contributing 
editor for OS/2 Magazine and has written 
for PC Week. Or. Dobb's Journal, and 
Programmer's Paradise. 
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LEARN OBJECTS FAST. 
DEVELOP MASTER. 


BusinessWeek 



Want to 
know the 
fastest way to 
learn objects- 
even for C++ 
developers? The 
experts recommend 
Smalltaik/V, the technology 
that’s 100% pure objects. 


FASTER, EASIER LEARNING. 


With C++, you have to 
accomplish two huge tasks: 
learning object class libraries, 
and learning new C++ language 
syntax. Plus C++ is a hybrid of C 
with added object extensions. So 
odds are, you’ll find yourself con¬ 
stantly falling back on familiar 
procedural methods and losing 
the benefit of objects. 

SmalltalkN has a simpler, 
more approachable language 
that lets you focus on 
learning objects instead 
of a new syntax. That’s 
why thousands of profes¬ 
sional programmers have 
found Smafltalk/V to be 
the fastest, most efficient 
way to learn the object- 
oriented paradigm. In fact, 


Smalltalk/V to the rescue. Simply 
by enabling large programs to be 
built from pretested software 
objects, it can provide tenfold 
leaps in programmer productivity 
and software quality. Perhaps 
more important, Smalltalk pio 
grams deal in terms programmer 
can understand. 




Ti 



C++ will make 
more sense once 
you learn OOP 
with SmalltalkN. 

But we think you'll want to con 
tinue using Smalltalk/V for your 
application development. 


DEVELOP lOx FASTER. 


Greg 1/oss of Windows Tech 
Journal says: " It’s notan exag¬ 
geration to say that most applica¬ 
tions of significant size can be 
built ten times faster in 
SmailtalkA/ than in C or C++. ” 
Gen Kiyooka of Windows Tech 
Journal agrees: “Nothing on 

earth can match the effi¬ 
ciency and productivity 
of experienced 
Smalltalk/V program¬ 
mers. Nothing.” And 
Business Week reminds 
us that some Wall Street 
firms now get their 
“computer models of 
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SMALLTALK/V. 100% PURE OBJECTS. 


brand-new finan¬ 
cial instruments 
done in days, not 
months." 


EASY TO USE. 


Here's hew Smalltalk/V 
cuts development 
time by as much as 
90%. •Easy-to-use 
integrated environ¬ 
ment. •Incremental compilation 
shows immediate results of code 
changes. •Over 350 well-tested 
reusable classes built-in and 
100's more available. •Class 
browsers and object inspectors 
to examine code and isolate 
errors. •Automatic memory man¬ 
agement to eliminate memory 
related bugs. •Easy access to 
3GL languages. •Integrated 
graphic debugger. •Available on 
Windows 3.1, Windows NT, OS/2 
and Macintosh. 

So if you want to learn objects 
fast - and develop lOx faster - 
punch this line of code into your 
telephone: (800) 531-2344 
Department 706. We'll send you 
complete information. 
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This issues Programming Insider discusses options available for writing objects under OS/2. Using 
Workplace objects with and without writing SOM, new technologies such as Direct-to-SOM and other 
approaches such as C++ and user interface class libraries are also explored. By DAVID REICH 


Objective OS/2 
Decisions 



David Reich 


s yon know, objects, object-ori¬ 
ented programming, classes, and 
libraries of classes are the hot 
topics in the computer industry right 
now. Many questions need to be an¬ 
swered when it comes to objects in gen¬ 
eral, not only when using or writing ap¬ 
plications for OS/2, but for any system. 
We will explore the current implementa¬ 
tions of objects on OS/2 here, and you 
will get some insight on where the use 
of objects is appropriate and where it 
may not be as advantageous as you 
might think. 

THE BENEFITS OF OBJECTS 

Back in the dark ages of procedural pro¬ 
gramming, the reinvention of the wheel 
was commonplace. At that time, reuse 
was copying chunks of code from one 
program to another. Eventually, the run¬ 
time library was born. The libraries 
were sets of reusable routines that could 
be linked into or bound to programs, so 
functions such as writing lines to the 
screen or opening files did not have to 
be rewritten (or copied) every time a 
new program was written. 

The run-time library concept was 
enhanced with the notion of dynami¬ 
cally linked libraries (DLLs). With the 
older run-time library, the code for the 
library routines used by the program 


was bound to the executable, so in a 
multitasking system such as OS/2, there 
could be many copies of a function 
(such as, fopen) resident in physical 
memory, each copy in a separate pro¬ 
gram. DLLs work like their predeces¬ 
sors, but the routines in the DLL can be 
shared by many programs, so only one 
copy of a routine need be in memory at 
any one time. 

While all of this was going on, there 
was an ongoing school of thought where 
rather than improve on the run-time 
idea, one would create reusable objects 
instead of just routines that can be called 
by programs. 

Objects can do work, communicate, and 
are intuitively more understandable by the 
average person than the run-time DLL, dy¬ 
namically qr statically linked, function library 
jargon used by programmers. People work 
with objects in everyday life; now program¬ 
mers can tea 

Object technology, other than being 
more intuitively understandable, pro¬ 
vides benefits such as data hiding, en¬ 
capsulation, and, most important, the 
ability to form the basis for other classes 
of objects where behaviors can be inher¬ 
ited, modified 1 , and added to. 

Object class libraries further isolate 
programs from the underlying hardware 
platform, and with the object interface 
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protocol (in general, just telling an 
object what you want it to do), they 
reduce the costs in creating portable 
applications. 

OBJECTS AND OS/2 

Early versions of OS/2 (version 
Lx) were object-based but not ob¬ 


ject-oriented. Some of the things on 
the screen looked like objects, and 
to programmers, some things were 
programmed and acted like objects 
(for example windows and win¬ 
dow procedures), but they still had 
procedural bases and lacked many 
of the benefits that a pure object- 


oriented implementation provides. 

Beginning with version 2.0, 
OS/2 contains a truly object-ori¬ 
ented user interface, with a real ob¬ 
ject-oriented engine underneath. 
This technology is not only avail¬ 
able to developers wanting to inte¬ 
grate their applications with or 
add extensions to the OS/2 Work¬ 
place Shell, but it is also there for 
any other object applications you 
might think of. 

SOM 

As you saw in the last two issues, 
the System Object Model (SOM) is 
the object technology IBM chose to 
implement the Workplace Shell. In 
fact, SOM is the strategic object di¬ 
rection for IBM's software prod¬ 
ucts and the foundation for much 
of its future technology. SOM is 
just that—an object technology. As 
shown in the previous issues with 
a SOM and Workplace Shell pro¬ 
gramming tutorial, SOM is essen¬ 
tially a base-class library and a 
message resolver All SOM objects 
are built on top of that base. The 
SOM run time, or DLL, is the en¬ 
gine that is used by applications. 
In general, SOM.DLL would have 
to be shipped with an application. 
However, because the engine is re¬ 
quired by the Workplace Shell, 
everyone who has OS/2 2.x al¬ 
ready has the SOM engine. 

SOM also has several flavors. 
The first release of SOM, and the 
one shipped with the current ver¬ 
sion of OS/2, is restricted to a sin¬ 
gle process. That is, although 
many processes or applications 
may use SOM as their object base 
and engine, if one SOM object 
wishes to communicate with an¬ 
other, both must be in the same 
process. That is why any 
Workplace Shell object you write 
must become part of the 
Workplace Shell process for it to 
use the Workplace Shell object 
classes and communicate with 
other Workplace Shell objects. 
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Recall that a Workplace Shell ob¬ 
ject is a SOM object, but a SOM ob¬ 
ject is not necessarily a Workplace 
Shell object. 

The SOMOBJECTS toolkit 
from IBM provides other flavors 
of SOM that allow objects in dif¬ 
ferent processes to communicate. 
And there are still other things, 
such as a SOM Workstation 
Enabler, that allow objects in dif¬ 
ferent processes on different com¬ 
puters to communicate (often re¬ 
ferred to as DSOM) to enable real 
client/server applications. 

WORKPLACE SHELL INTEGRATION 

Now that some of the fundamen¬ 
tals are understood, let's look at 
how to integrate your applications 
with the Workplace Shell. You al¬ 
ready know you can create your 
own applications or systems using 
SOM as the engine. Integrating 
your applications with the 
Workplace Shell can be done with 
or without using SOM. 

The first question is: How is an 
application integrated with the 
Workplace Shell? Some people 
think they need to write their ap¬ 
plication as an object. Although 
that can be done, the idea is to 
write the application as an opera¬ 
tor and the object as the operand. 

For example, a document ob¬ 
ject is a Workplace Shell object that 
represents a document. In reality, 
this is (but does not have to be) a 
data file in the file system. When a 
user drags a document to a printer 
object, for example, and drops it 
there, the object is called or in¬ 
voked at the appropriate method. 
In the case of the printer, that 
method is wpPrintDbject. If the class 
that object belongs to handles or 
overrides that method, the object's 
class will handle what needs to be 
done. If not, the method call goes 
up the ancestry chain to a parent 
class that does handle that method. 
This is the advantage of true ob¬ 
ject-oriented programming. 


THE THREE STEPS TO WORKPLACE 
SHELL INTEGRATION 

Workplace Shell integration in your 
application does not require you to 
write a new object class using 
SOM. You of course can, but there 
are some ways to integrate your 
application with the shell that do 


not require programming to SOM. 
Step 1: Basic Drag-n-Drop . The 

first thing a user is likely to try 
when confronted with an object-ori¬ 
ented user interface is to take a doc¬ 
ument object and drag and drop it 
on a program object. A new object 
class is not needed to support this. 
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When a user drops a docu¬ 
ment object onto a program object, 
the shell starts the program and 
passes the name of the data file the 
document object represents as a 
"command line" parameter (that 
is, the argc, argv values in the case 
of a C language program). If your 
application handles command-line 
parameters, you already support 
drag-and-drop object-oriented ap¬ 
plication launching. 

Step 2: Associations. The next 
step is associations. Wouldn't it be 
nice if a user could simply open 
(by double clicking) a document, 
and it would be presented in the 
way that person is used to seeing 
it? Using only Step 1, you cannot 
provide that. However, using asso¬ 
ciations, you can provide users this 
function as well. 

Associations are a Workplace 
Shell feature that associate file 
types with executable programs or 
program objects. Some are pro¬ 
vided by the operating system (for 
example, when you click on the 
README file and it comes up in¬ 
side the system editor); others can 
be created by users, and you as a 
programmer can build associations 
into your programs. 

In general, an association is 
created between an executable pro¬ 
gram and a file filter (such as 
*.DOC) or file type (such as "My 
Document"), which may or may 
not have file filters underneath. 
When an object is opened, the shell 
knows if that object type or if the 
file extension has an association, 
the shell will launch the associated 
application and pass the data file 
name as a command line parame¬ 
ter as explained in Step 1. 


Associations can be created by the 
user with the settings notebook for 
a program object. 

You as a programmer can re¬ 
lieve the users of your applications 
from having to set up associations 
by using an ASSOCTABLE. ASSOCTABLE is 
the statement and table you build 
into the resources of your applica¬ 
tion. When an executable file is 
first looked at by the shell (for ex¬ 
ample, when you create the pro¬ 
gram object for the shell), the .EXE 
file is examined to see if there is an 
association table. If so, the shell 
builds the associations defined in 
it. This way, you can set up the as¬ 
sociations without the user having 
to do it. 

A sample ASSOCTABLE is shown 
in Figure 1. In this example, the 
name of the association is "My 
Document", and the file filter is *.MD. 
When any document object that 
represents a file with the .MD ex¬ 
tension is opened, an attempt will 
be made to start the executable 
program, loading this data file. A 
custom icon is also in this example. 
When a folder containing docu¬ 
ment objects that are *.MD files is 
opened, each document object will 
have MYDOC.ICO as the icon. 

Another advantage of using an 
ASSOCTABLE instead of having the 
user create the association is that 
when the ASSOCTABLE is read by the 
shell, it creates a template in the 
templates folder for each docu¬ 
ment or object type in the AS¬ 
SOCTABLE. Now your users can create 
new documents by simply "tearing 
off" a new one from a template. 

Step 3: An Object Class. As you 
can see, you can provide your 
users a great deal of functionality 


without writing your own object 
class. However, if you want or 
need to provide more shell interac¬ 
tion than described here (for exam¬ 
ple, drag-and-drop printing with 
other than plain text or printer- 
specific files), you will need to 
write a Workplace Shell object 
class. 

Writing a Workplace Shell ob¬ 
ject class today involves writing 
SOM code, using the Workplace 
Shell object class hierarchy as a 
basis, and creating a DLL for your 
class that will become part of the 
shell process. This was described 
in detail with some sample code in 
"More InSOMnia and Workplace 
Shell Programming (July/August 
1994). 

One of the reasons I use the 
qualifier "today" is that there is 
work going on by some compiler 
vendors to provide Direct-to-SOM, 
which I will explain in a moment. 

The net result is that Work¬ 
place Shell integration does not re¬ 
quire SOM code to be written. 
Writing SOM or Workplace Shell 
object classes, however, can ease 
portability and increase the 
amount of code reuse you can 
enjoy. 

TOOLS 

At this time, SOM tools are, shall 
we say, less than numerous. More 
to the point, other than the SOM 
emitters that come in the OS/2 
Developers' Toolkit or the SOM- 
OBJECTS Toolkit, there really 
aren't any yet. However, some are 
in the works. 

SOM AND C 

SOM itself is really not a program¬ 
ming tool but, as shown previ¬ 
ously, more of an engine. To use 
SOM today, however, the emitters 
are required to process (or pre- 
process) the language-neutral SOM 
source code into source for the tar¬ 
get language compiler (most likely 
C or C++). 



Figure 1 . A sample association table. 
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The language-neutral code is 
processed by the SOM emitters 
and produces C code that is input 
to your C compiler- The resulting 
object code is subsequently linked 
into a DLL that is the executable 
implementation of your class. 

COMPILERS AND C++ 

Nothing is wrong with choosing 
C++ to implement objects and ob¬ 
ject classes in your applications. 
There is no law saying that SOM is 
the only thing you can use. In fact 
extensive C++ class libraries are 
now available for OS/2 C++ com¬ 
pilers, Object-oriented program¬ 
ming using these class libraries is a 
viable alternative to SOM, espe¬ 
cially if you are not particularly 
concerned about porting to SOM 
later, or if your application plat¬ 
form has no SOM implementation. 

However, if you plan on de¬ 
signing your applications for IBM 
operating systems, you should se¬ 
riously consider SOM as the object 
engine, since that is where IBM is 
heading, 

DIRECT-W-SOM 

As you have probably already con¬ 
cluded, a SOM preprocessor or 
emitter is not the most desirable 
way to write object code. You have 
to write the language neutral code, 
process that, merge it with your C 
or C++ code, and then compile it. 
That is what it takes today to use 
SOM, 

Wouldn't it be nice if you 
could embed code in your C or 


C++ files that allows the objects 
and classes you construct to use 
the SOM engine and base class im- 
plementation? That is where 
Direct-to-SOM (DTS) comes in, 

DTS is being implemented by 
some compiler makers, so code 
written in C or C++ can interface 
directly with the SOM engine, and 
no preprocessing is needed. 
Unfortunately, no DTS compilers 
are commercially available today, 
but they are in the works. DTS will 
take the extra preprocessing step 
out of the equation, and you will 
not have to learn SOM coding, 

OTHER OBJECT LANGUAGES 

Although we've only discussed 
using the more traditional C, C++, 
and SOM for writing object-ori¬ 
ented code, there are other tools, 
such as some REXX-based object- 
oriented programming tools. With 
these tools, you can take prede¬ 
fined object classes and, using 
some of their visual drag-and-drop 
programming models, quickly cre¬ 
ate REXX applications. 

WHETHER OR NOT 
TO WRITE AN OBJECT 

So, should you write an object? If 
you want to integrate your appli¬ 
cation with the Workplace Shell, 
look to see how much integration 
you want or need. If all you're 
looking for is simple application 
launching and document manipu¬ 
lation, you can use associations. If 
you want more custom behavior in 
a wider variety of situations, a 


SOM or Workplace Shell object 
class is what you want. 

As you can see, there are many 
choices. Workplace Shell object 
programming is a very focused 
topic. For other implementations 
than Workplace Shell integration, 
you have choices such as C ++, 
SOM, or even some REXX-based 
tools. Your object choices should 
be determined by how portable 
you need the code to be and what 
overhead you are willing to live 
with (to use the object class run¬ 
time libraries and so on). 

Object-oriented programming is 
where things are going. Some of the 
tools available right now are some¬ 
what primitive, such as having to 
emit C files from SOM rather than 
having DTS functions available in 
compilers. But others are full-func¬ 
tioned integrated programming en¬ 
vironments, Things are advancing 
quickly The best advice I can give is 
don't waste time using technologies 
that don't look like they're here for 
the long run. SOM is. Not only is 
IBM behind it, but other companies 
are as well. As operating systems 
evolve, so will SOM and its tools. 

David Reich has been with the IBM OS/2 
development team since 1987. He has 
worked on many parts of the system , sup¬ 
ported customers and application develop¬ 
ers, and traveled the world giving seminars 
and teaching OS/2 . He is the author of ; 
Designing OS/2 Applications, published by 
John Wiley and Sons. He can be reached 
on CompuServe at 76711 f 832 or via 
Internet at speedracer@vnet.ibm.com. 
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This article explains how OpenDoc. Taligent, and SOM come together and what they mean to 
developers. By CLIFF REEVES, BOB ORFALI, and DAN HARKEY 


A Distributed Object 
Road Map For 
Developers 


r he new generation of multitask¬ 
ing desktop operating systems— 
such as OS/2—has the potential 
to radically change the nature of distrib¬ 
uted computing. Instead of the classic 
client/server model, we can envisage 
the day when hundreds of millions of 
machines will be both clients and 
servers. To take advantage of these new 
forms of distributed computing, infor¬ 
mation systems will be created by as¬ 
sembling live blobs of intelligence and 
data in an infinite number of Lego-like 
arrangements. Today's monolithic appli¬ 
cations will be broken down into self¬ 
managing components that can play to¬ 
gether and roam across networks and 
operating systems. Distributed objects 
are our best hope for realizing this po¬ 
tential—they represent the ultimate 
form of client/server distribution. 

Objects are self-managing, intelli¬ 
gent entities that are infinitely malleable. 
They allow us to distribute intelligence 
at a very fine-grained level and at the 
same time can be used to encapsulate 
existing applications. However, for ob¬ 
jects to realize their distributed poten¬ 
tial—both on the desktop and across 
client/server networks—they require an 
infrastructure. We will use a hardware 
analogy—the IBM PC—to explain the 
pieces of this infrastructure and how 


they come together. We explain where 
CORBA, SOMobjects, OpenDoc, and 
Taligent fit. The PC created an extremely 
successful industry. The distributed ob¬ 
ject infrastructure offers a similar oppor¬ 
tunity for software developers. 

ORB: THE SOFTWARE BUS 

The single most important component 
in the original PC was the hardware 
bus; it was open and allowed any ven- 
dor's adapter to plug in. The object 
equivalent of an open bus is the Object 
Request Broker (ORB). Fortunately, this 
time around, our industry anticipated 
the need for a software bus and the 
Object Management Group (OMG)—a 
consortium of 400 vendors—was 
founded in 1989 to create distributed ob¬ 
ject standards before any major products 
were introduced. The result was the 
Common Object Request Broker 
Architecture, or CORBA. 1 

CORBA defines how server objects 
expose their service interfaces to the bus 
and how clients can call these server ob¬ 
jects using static or dynamic API 
method invocations, as shown in Figure 
1. Currently, the CORBA 1.1 software 
bus supports cross-language and cross- 
platform object interactions. Com¬ 
mercial examples of CORBA-compliant 
ORBs include IBM's DSOM, Hewlett- 
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Packard's DOMF, and SunSoft's 
DOE, CORBA 2.0, due late 1994, 
provides a standard for intergalac- 
tic object communications across 
multivendor ORBs. 

THE COMMON OBJECT SERVICES 
EVERY BUS MUST PROVIDE 

One of the painful lessons learned 
from the PC was that the bus 
quickly became the single worst 
bottleneck in the system—it was 
not designed for high-bandwidth 
and expansion. Luckily, the object 
industry did not fall into this trap, 
OMG divided the bus design activ¬ 
ity into the ORB and the common 
object services that every ORB 
must provide, as illustrated in 
Figure 2. These add-on services are 
object classes that are defined 
using the CORBA Interface Def¬ 
inition Language (IDL). 


So instead of one giant mono¬ 
lithic bus, OMG created a bus with 
modular add-on object services, 
each defined by leading industry 
experts in a software middleware 
area. Each add-on provides an es¬ 
sential object service for the bus. 
This is the ultimate in modular bus 
design, OMG has currently de¬ 
fined standards for four Common 
Object Services: 

• The object lifecycle service 
defines operations for creating, 
copying, moving, and deleting 
objects on the bus. These opera¬ 
tions can also handle associa¬ 
tions between groups of related 
objects. For example, if you 
move a document, the service is 
smart enough to also move its 
embedded object parts; this will 
help us deploy nomadic objects 
that roam on the bus. The ser¬ 


vice also defines interfaces to 
factories that can create new 
objects on different machines. 

* The object persistence service 
allows objects to persist beyond 
the application that creates the 
object or the clients that use it. 
The service is designed for maxi¬ 
mum flexibility. It can accommo¬ 
date a variety of storage ser¬ 
vices, including ODBMSs, 
RDBMSs, and document filing 
systems (like Bento). The idea 
was to create an open implemen¬ 
tation that meets the different 
storage requirements of objects; 
it encompasses the needs of 
large-grained objects (such as 
documents) as well as fine¬ 
grained objects {such as SQL 
table rows). 

1 The object naming service allows 
objects on the bus to locate other 
objects. This service can use 
existing network directories 
such as ISO X.500, OSF's DCE, 
or SUN's NIS. The service sup¬ 
ports naming hierarchies that 
allow clients to navigate differ¬ 
ent naming context trees in 
search of the objects they're 
looking for. 

• The object event service allows 
objects on the bus to dynami¬ 
cally register or unregister their 
interest in specific events. An 
event is an occurrence within an 
object specified to be of interest 
to one or more objects. A notifi¬ 
cation is a message sent to the 
specific parties informing them 
that a specific event occurred. 
Normally, the object generating 
the event does not have to know 
who the interested parties are. 
This is all handled by the Event 
Service, which creates a loosely 
coupled communication channel 
between objects on the ORB that 
don't know much about each 
other. 

OMG is working on additional 

ORB-based object services, includ¬ 
ing transactions, security, concur- 



Figure I. Client/server object interactions on a CORBA ORB 



Figure Z The components of the OMG software bus for objects 
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rency control, licensing, security, 
query, and object properties. 
When they are ready, these ser¬ 
vices can be added to CORBA- 
compliant ORBs incrementally. A 
wide coalition of vendors is using 
this common object infrastructure 
to build the next generation of 
distributed services* CORBA- 
compliant ORBs—like DSOM— 
will be able to provide an incre¬ 
mental set of core services for 
distributed objects. For DSOM, 
IBM will provide these services 
first in toolkit form—for example, 
SOMobjects—and then incorporate 
them into OS/2 (and other operat¬ 
ing systems). This will ensure that 
the object bus is ubiquitous. 

To go back to the PC analogy, 
we now have a well-engineered 
software bus and the chassis to 
house it. In contrast to the PC 


hardware bus, our software bus is 
being built from the ground up to 
support intergalactic communica¬ 
tions {for example, DSOM and 
DOMF both will run on top of the 
QSF's DCE). And in contrast to the 
PC bus, the software bus is an 


open industry standard—it is not 
controlled by a single vendor. But 
where is the equivalent of the 
adapter boards that do all the Teal 
work on the software bus? This is 
where object frameworks come 
into the picture. 




Figure 3 , Frameworks: prewired object software boards 
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FRAMEWORKS: THE 
SOFTWARE BOARDS 

Hardware vendors understood 
that an open bus was an open invi¬ 
tation to create adapter boards to 
provide specialized functions—in¬ 
cluding LAN communications, 
storage, multimedia, and fax. 
Whole new industries were created 
by wiring together individual 
hardware modules into adapters 
that plugged into the bus. 
Frameworks are the software 
equivalent of hardware boards, as 
illustrated in Figure 3. Frameworks 
are a set of software objects that 
collaborate to provide a special 
function* Think of them as 
prewired software classes that do 
something useful on the bus. They 
are factory-debugged software 
subsystems or software boards. 
Unlike hardware boards, you 
can customize a software frame¬ 
work to suit your application 
needs. You customize a framework 
by telling it which key events you 
want to personalize and providing 
the code that handles those events. 
The framework then calls your 
code when that event occurs; your 
code doesn't call the framework, as 
shown in Figure 4, Your programs 
don't have to worry about struc¬ 
ture, flow of execution, or calls to 
system-level API libraries. 

If you're an object-oriented 
programmer, frameworks provide 
architectural guidance. They re¬ 
move the need to shop for classes 
and discover which methods are 
available, how to call them, and in 
which order. It's like buying a 
board instead of individual chips. 
The services provided by the 
framework are defined using the 
CORBA IDL, As illustrated in 
Figure 5, an application becomes a 
collection of little puzzle pieces 
that inherit functions from the 
framework and call the framework 
APIs via the ORB, 

IBM and Taligent intend to 
ship CORBA-compliant frame¬ 


works for all types of middleware 
and desktop functions. You can 
then modify these frameworks to 
suit your application needs. But 
IBM and Taligent won't be alone. 
Obviously, there is room for a vi¬ 
brant collection of innovative 
frameworks on the software bus to 
come from many vendors. 

Table 1 provides a quick sum¬ 
mary of the features that distin¬ 
guish a framework from proce¬ 
dural API programming and 
object-oriented class libraries. 

OPENDOC: CONNECTING TODAYS 
DESKTOP TO THE BUS 

The software bus is a prerequisite 
for creating a component-based 
software industry. However a bus 
alone is not enough, especially in 
complex areas such as the desktop, 


where there's a need for protocols 
that allow components to visually 
coexist, share containers of data, 
and respond to events (and scripts) 
in a unified manner. In other 
words, we need a desktop infra¬ 
structure that sits on the bus and 
defines the rules of engagement by 
which the visual components can 
plug-and-play. OpenDoc provides 
such a standard. 2 In our bus anal 1 
ogy, OpenDoc is a standard for 
what goes on inside a desktop soft¬ 
ware board, as illustrated in Figure 
6. To use the hardware analogy, 
OpenDoc is a specialized desktop 
adapter with special sockets that 
let you plug in your parts. You can 
develop your parts by inheriting 
function from frameworks, encap¬ 
sulating existing code, or using 
OpenDoc part-builder tools. An 



Figure 4. Procedural vs. framework approaches to developing code 



Figure 5, A framework-based application 
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Figure 6, OpenDoc: the desktop software board 


OpenDoc part is similar to an OLE 
2* *0 OCX (in fact, OCXs can play in¬ 
side OpenDoc containers and vice 
versa)* 

OpenDoc provides its open 
sockets for parts by bringing the 
software bus (or ORB) inside the 
adapter and defining new services 
(and APIs) that can be used by 
software component providers to 
create visual software parts that 
plug-and-play into visual and file- 
based containers. Following are 
the three new services provided by 
OpenDoc: 

* Bento provides storage proto¬ 
cols for defining rich data types 
and their boundaries. Bento 
also defines the protocols by 
which various parts can coexist 
in the same file container. Each 
part can have its own data type 
and can own a portion of the 
file container* Bento also allows 
you to interchange parts across 
platforms. 

* Compound document manage¬ 
ment defines the visual contain¬ 
ment protocols that allow vari¬ 
ous parts to be embedded and 
activated from within visual 
containers* OpenDoc is a form of 
object-oriented user interface 
that uses a document-centric 
paradigm for displaying parts* 
This paradigm should be very 
familiar to OS/2 Workplace 
Shell users* When you need to 
work on an object, you simply 
click on it. In fact, parts can be 
moved from OpenDoc docu¬ 
ment containers to Workplace 
Shell containers and vice versa* 
OpenDoc creates live docu¬ 
ments* For example, an Open¬ 
Doc document is not a set of 
"dead bits/' Instead, it can be 
brought to life by a simple click, 
and its contents can be edited 
and changed "in place." Meta 
Group predicts that by 1997, 
compound documents will 
become the primary paradigm 
for capturing information, thus 


challenging the dominance of 
record-oriented data* 

Open scripting architecture 
defines interfaces for allowing 
parts to respond to scripting 
commands and other external 
events. Users will be able to 


write custom applications by 
assembling multivendor parts 
and synchronizing their behav¬ 
ior by writing (or recording) 
scripts* 

The beauty of OpenDoc is that 
all the system components and the 


GET FAST ANSWERS 

To Your Development Questions 


You need to do two things: 

• Go on-line with 
CompuServe* 

* Use Golden 
CommPass to do it* 

CompuServe hosts OS/2 
developer and user 
forums* IBM 
developers have 
responses to anything 
that’s got you stuck. 

Other OS/2 
programmers and 
enthusiasts are 
there, too, comparing 
notes and giving feedback* 
It’s definitely the place to be. 


Golden CommPass 

OS/2® Navigation Sorcm>E 

Creative Systems Programming Corporation 
(609) 234*1500 - Fax: (609) 234-1920 
Internet: 71511*151 @CompuServe*com 



Time is money when you connect 
to CompuServe, and Golden 
CommPass saves you both. It lets 
you compose your questions 
off-line, send them in a 
flash and disconnect. It 
gets your replies 
while you’re 
busy programming* 


Golden CommPass 
keeps your develop¬ 
ment schedule on 
course* The fact is, 
the sooner you start 
using our program, the 
sooner they’ll be talking 
about yours. 
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Feature 

Frameworks 

Object-Oriented 

Class Libraries 

Procedural APIs 

Application model 

Frameworks are the 
application. Frame¬ 
works handle all the 
control flow. 

You must create the 
control flow of the 
application and the 
glue that ties the dif¬ 
ferent class libraries 
together. 

You must create the 
control flow of the 
application and the 
logic that invokes 
the APIs. The system 
knows nothing about 
your code. 

Application structure 

Multiple cooperative 
frameworks. 

Single monolithic 
application consist¬ 
ing of class libraries. 

Single monolithic 
application linked to 

API libraries. 

How services are 
obtained 

Frameworks are the 
service. 

By inheriting func¬ 
tion from the class 
libraries. 

By calling API libraries. 

How the system 
is customized 

Frameworks call 
your code. You can 
subclass parts of 
frameworks. 

By subclassing or 
creating new classes. 

By writing new code 
and calling additional 
APIs. 

Granularity of control 

Medium. You can 
only subclass parts 
of frameworks. 

High. You can sub¬ 
class any class. 

High. You can write 
everything from 
scratch. 

Abstraction of services 

High. Hides com¬ 
plexity. Automates 
standard features. 

You program by 
exception. 

Low. Hides APIs but 
creates its own layer 
of complexity—you 
must determine 
which methods are 
available to call and 
in which order. 

Very low. You need to 
deal with raw APIs 
and determine the 
order in which to call 
them. 

How much code 
do you write? 

Very little. 

A medium amount. 

A lot. 

Maintenance costs 

Low. 

Medium. 

High. 

Reduced complexity 

Yes. You write small 
pieces of code within 
multiple frameworks. 
Frameworks call you 
only when necessary. 
Frameworks provide 
architectural guidance. 

No. You must shop 
for classes and de¬ 
velop the program. 

You must integrate 
the different class 
libraries. 

No. You must devel¬ 
op the entire program 
and understand how 
the APIs work 
together. 


Table 1. Comparing frameworks, object-oriented class libraries, and procedural APIs (adapted with permission from Client/Server 
Survival Guide with 0S/2/ 
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add-on parts communicate over 
the same object bus (the DSOM 
ORB). OpenDoc demonstrates that 
the same object model—the 
CORBA ORB—can be used to con¬ 
nect interga lactic objects as well as 
fine-grained visual objects that re¬ 
side on a common desktop. It is all 
very consistent. OpenDoc allows 
you to repackage monolithic desk¬ 
top applications into parts that can 
plug and play together on the 
same desktop or across the net¬ 
work. You'll need to encapsulate 
these applications with SOM 
wrappers and break them into 
parts and part editors. Taligent 
frameworks will allow you to go 
even further and create visual 
parts that inherit their behavior 
from prewired frameworks—this 
is good if you have the luxury of 
creating new applications. 4 

IF WE BUILD IT WILL THEY COME? 

Together SOM, SOMobjects, 
OpenDoc, and Taligent frame¬ 
works provide an object infrastruc¬ 
ture plus the basic building blocks 
that will help developers create 
parts, components, and vertical 
frameworks that populate this in¬ 
frastructure. To use the hardware 
analogy, writing a part with 
SOMobjects and DSOM is like de¬ 
veloping a hardware chip. Writing 
an OpenDoc part is like develop¬ 
ing a chip that plugs into a 
prewired board with open sock¬ 
ets—all you do is supply the parts 


and they will interplay with other 
parts. Writing frameworks is like 
buying a prewired subsystem that 
you can then simply customize to 
fit your needs. 

Most users will buy either 
parts they can script together or 
entire frameworks they can cus¬ 
tomize for their particular needs. 
In either case, some form of user 
customization will become the 
norm. IBM and Taligent intend to 
provide the tools that further facili¬ 
tate this process. The success of the 
objects industry depends on mak¬ 
ing our software components as 
easy to assemble as the new gener¬ 
ation of PC plug-and-play busses 
make it for hardware. 

Cliff Reeves is the Director of Object 
Technology Products, IBM Personal 


Software Products Division. Reeves is cur - 
rently responsible for object-based prod¬ 
ucts in the IBM Personal Software 
Products Division. This includes responsi¬ 
bility for the IBM/Taligent partnership, 
SOM, and OpenDoc. 

Bob Orfaii and Dan Harkey are the 

authors of the bestselling book 
Client/Server Programming with OS/2 
(VNR, 1993). Bob and Dan's most recent 
book is the Client/Server Survival Guide 
with OS/2 (VNR, 1994). This 930-page book 
contains over 150 pages on distributed 
objects. Bob and Dan have been develop¬ 
ing client/server applications and tools for 
the last eight years. They currently work 
on the application of distributed object 
technology. Bob and Dan are affiliated 
with IBM Personal Software Products 
Division, Austin, Texas. They work from 
the San Francisco Bay Area. 
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In our previous article on OpenDoc ("Component Software for the Masses: OpenDoc is Here, 

July/August 1994), we introduced the major technologies contributed by IBM, Apple, and WordPerfect to 
the Component Integration Laboratories (CILabs) consortium: SOM, BENTO, OSA, and the OpenDoc com¬ 
pound document architecture. This article will focus on OpenDoc s compound document technology. 

By ROBERT L TYCAST 


OpenDoc Basic 
Anatomy 101 


n OpenDoc, we stretch the docu¬ 
ment metaphor in many ways. 
From the OpenDoc point of view, 
everything that a user builds, manipu¬ 
lates, and stores is a document. Diverse 
elements from simple sound bites to the 
OS/2 desktop itself can be documents. 
The sound bite can have a visual trigger, 
such as a push button or an icon, which 
causes its contents to be retrieved and 
played as a dog's bark, a fragment of a 
song, or a sound effect. At the other end 
of the spectrum, the desktop is a com¬ 
plex hierarchy of documents within doc¬ 
uments. Folders are subdocuments 
within the desktop, and those folders 
contain further subdocuments. 

In OpenDoc, these subdocuments 
are referred to as parts that are embed¬ 
ded in some containing document. We 
will see how these concepts are born of 
the objects that make up the OpenDoc 
run time. 

PART 

A part is the building block of OpenDoc. 
Every document contains at least one 
part, and each part owns some real es¬ 
tate in the document called a frame. A 
part defines the type of data that can 
exist in its frame as well as the editing 
conventions that apply. For instance, a 
structured graphics part would have 


data that corresponds to shapes. A text 
part would have data stored as charac¬ 
ters, words, lines, and so on. Graphical 
objects created by the structured graph¬ 
ics parts might be manipulated by han¬ 
dles. Text might be edited by using cur¬ 
sors and simple delete operations or 
more complex selections of text dis¬ 
played as highlighted lines. The point is 
that each part has complete freedom to 
define both the data types and the edit¬ 
ing conventions. 

In a very real sense, the parts corre¬ 
spond to applications in today's world. 
The first part defined for a document is 
called the root part, which defines the 
overall conventions for the document. A 
simple document will have only one 
part: the root. So in OpenDoc terms, to¬ 
day's applications are simply docu¬ 
ments with only a root part. 

More complex documents will of 
course have more than one part within 
them. But before we can go on in our 
discussion we must define some addi¬ 
tional terms. 

EMBEDDING PARTS 

The root part initially owns all the docu¬ 
ment's real estate in a single frame. But 
if it is truly OpenDoc compliant, it will 
be able to create new frames within it¬ 
self, called embedded frames. (A part is 
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not required to embed other parts. 
It is up to the implementor to de¬ 
cide whether or not to allow em¬ 
bedding. But if a part does not 
embed other parts, its usefulness is 
severly limited,) These frames are 
OpenDoc content objects that con¬ 
tain parts. They are manipulated— 
moved, resized, and deleted—ac- 



Figure 1 . Embedded parts in an OpenDoc 
document 


cording to the rules of the part, 
usually the same policies that 
apply to the part's other content 
objects* 

These embedded frames are 
special, however. While they are 
created and manipulated by the 
containing part, they are given to a 
new part that governs what is in 
the embedded frames. This may 
sound a little confusing at first, but 
it is the key to understanding 
what's happening in OpenDoc. 

In Figure 1, the root part has 
two embedded parts—A and B. 
Part B contains embedded Part C. 
If the user wants to change the lay¬ 
out of the document by moving ei¬ 
ther A or B, it is the root part's re¬ 
sponsibility to provide the means 
to select the embedded frames. If 
Part C must be moved, it would be 
Part B's responsibility since Part C 
is embedded in it. 

We started off looking at the 
root part and its capability of creat¬ 
ing embedded frames and are now 
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Figure 2, Object hierarchy 


examining an embedded frame— 
Part B in Figure 1—that does its 
own embedding. It turns out that 
the only thing special about a root 
part is that it was the first part se¬ 
lected for the document. Other¬ 
wise, it operates identically to 
parts that come later in the hierar¬ 
chy. You can still embed other parts 
by creating embedded frames in the 
parts that require them. 

DOCUMENT SHELL 

The document shell (DOCSHELL.EKE) 
provides the document with the 
basic environment in which the 
component parts can execute. It 
provides the process and memory 
context for the document as well as 
some common services that all 
parts will need. For instance, the 
document shell is responsible for 
dispatching any messages or 
events to the correct destination. 
These might be the result of ac¬ 
tions by the user or messages sent 
between documents and parts of 
documents. 

Access to certain resources 
must be serialized at a document 
level for parts to share them. The 
document shell provides an arbitra¬ 
tor object that enforces a protocol 
for sharing menus, the mouse and 
keyboard, modal focus, and so on. 
Each shareable resource has a focus 
module associated with it. The 
mechanism is extensible, and any 
resource that needs to be shared in 
a document can use the arbitrator 
simply by creating and registering 
an object called a focus module. 

Document shells are delivered 
as part of the OpenDoc implemen¬ 
tation on the platform. In most 
cases, this default "docsheil" will 
be all that is needed since it is the 
parts in general, and the root part 
in particular, that actually define 
the character of the document, not 
the document shell. 

One case in which a software 
developer might create a docu¬ 
ment shell is when an existing ap- 
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plication is being migrated to 
OpenDoc in an evolutionary man¬ 
ner. As a first step, the application 
can be modified to contain 
OpenDoc parts, even though the 
application itself could not be em¬ 
bedded in an OpenDoc container. 

In this case, the application 
would in effect be converted into a 
document shell with a hard-wired 
root part, representing the native 
data type of the application* At a 
later date, other steps would be 
taken to completely decompose 
the application into component 
parts. At that point, the application 
would cease to exist as such, re¬ 
placed by the set of parts that 
would now run under the auspices 
of the default document shell The 
specialized document shell pro¬ 
duced as an intermediary step 
would no longer be needed and 
would be discarded, 

PARTHANDLERS 

The heart of the OpenDoc hierar¬ 
chy is the part object. It is nothing 
more than an abstract class with all 
virtual functions. In the OpenDoc 
world, it is the part that is deliv¬ 
ered to the user, and it is the part 
handler that implements all the 
methods of the part object. Part 
handlers can be divided into two 
general classes: part editors and 
part viewers. 

Part editors , Part editors are the 
workhorses of OpenDoc. They 
provide the functionality to create 
new part data in an OpenDoc doc¬ 
ument and to change existing data. 
Part editors will be marketed and 
sold as OpenDoc parts individu¬ 
ally or possibly as part of a pack¬ 
age of complementary parts bun¬ 
dled together for the user's 
convenience. 

Part viewers. Part viewers are 
scaled-down versions of part ed i¬ 
tors, They do not contain functions 
necessary to create new part data. 
They can only render data within a 
document The existence of a part 


viewer on a platform, however, en¬ 
sures that a part's data can be ren¬ 
dered with maximal fidelity on 
that platform. 

The idea is that while part edi¬ 
tors have to be purchased to be li¬ 
censed and used, part viewers 


should be made available for little 
or no cost on all platforms. For any 
given category of data, text for ex¬ 
ample, it is likely that each user 
will have purchased a part editor 
of his or her preference. When a 
data file is exchanged among mul- 
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tiple users, it is unlikely they all 
will have exactly the same prefer¬ 
ence for a text editor part. But 
since they all will have a part 
viewer for the common text for¬ 
mats, they all will be able to view 
the document with the appropriate 
part viewer. 


OBJECT HIERARCHY 

The OpenDoc library includes a set 
of objects that provide services to 
the OpenDoc shell and to part han¬ 
dlers. Figure 2 shows the hierarchy. 
A discussion of the vita! objects 
follows. 

Drafts . A draft is a unique ver¬ 
sion of the document that a user is 
working on. Each document starts 
out as a single draft. Each time the 
user decides to save the document, 
a new draft is created and the old 
one archived. So OpenDoc provides 


a de facto archiving mechanism 
transparent to the user. The actual 
mechanism is extremely efficient 
since as each draft is saved, only the 
changes from the previous draft are 
actually retained. 

At any time, the user can de¬ 
cide to retrieve a previous draft 
and work on it. This sets the stage 
for future collaboration facilities 
where different users can work on 
a document simultaneously, each 
with their own drafts, without fear 
of interfering with others. 

Storage units . Each draft is 
made up of one to many storage 
units. The storage units are used 
by the part handlers for data. 
Storage units can be in memory, on 
the clipboard, as links, or on disk. 
Since each is an instance of the 
same class, it is quite easy and con¬ 
venient for a part handler to put or 
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take its data from a storage unit in¬ 
terface and let OpenDoc handle is¬ 
sues like making the data persis¬ 
tent, copying to and from the 
clipboard, or retrieving a link from 
a remote document In each case, 
the interface is always the same 
storage unit object 

Frames. Parts are embedded in 
other parts by creating a frame and 
starting up an instance of that part 
within it. It is through the frames 
that are embedded in a containing 
part that the layout of the docu¬ 
ment is determined. When a docu¬ 
ment's draft is saved, the set of 
frames and their geometry are 
made persistent. 

Facets . Facets represent the 
areas of a part's frame that are visi¬ 
ble during run time. Whenever a 
part becomes visible, it is given 
one or more facets, and the part's 
draw method is called to allow it 
to render itself. A part may have 
become visible for many reasons. 
For instance, it may have just been 
embedded into a document, an oc¬ 
cluding part may have moved, or 
the user scrolled the page on 
which the part's frame is located 
onto the screen. 

The facets are ephemeral. 
During the normal course of edit¬ 
ing a document, the facets will 
come and go. They are not stored 
with the document data. When an 
existing document is opened, the 
containing part will determine 
which parts are visible based on 
the stored frame layout, facets will 
be constructed for all of the visible 
parts, and the appropriate draw 
methods are called. 

Canvases . Canvas objects are 
platform-specific objects that rep¬ 
resent the context with which the 
part handler renders. In Pre¬ 
sentation Manager, this would be 
akin to a presentation space or a 
device context. 

There are two basic flavors of 
canvas: static and dynamic. A dy¬ 
namic canvas is used to render a 
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part on the screen. A static canvas 
is used for printing. When a part 
is asked to draw itself, it can 
query to type of canvas it has, and 
if it is static, it may decide to ren¬ 
der itself differently Scroll bars 
are not usually useful on a printed 
page, so a part handler that nor¬ 
mally has scroll bars on the screen 
will typically omit the scroll bars 
when printing (that is, it has a sta¬ 
tic canvas). 

Robert L Tyeast, IBM Entry Systems 
Division, Boca Raton, Fla. f is an advisory 
programmer for the Advanced Pre¬ 
sentation Manager Development group . 
He joined IBM Corp , in 1989 from Digital 
Equipment Corp „ where he served in a 
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U.S., Latin America „ and Europe. His pro¬ 
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includes XI l Al Technology (LISP and 
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(VMS and ULTRIXl Tycast has a B.S. from I 

Massachusetts Institute of Technology ■■■ ■ 
and has done graduate work in MIT's com¬ 
puter science department. 
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You NeecI Assistance! 

Who doesn't? Now one toot provides the assistance you need. 


6 Utilities 
In One 


Wouldn't you like your applications to work the way you 
work? The power and complexity of today's applications require 
compromises in the design, location, and default settings of all 
features. People often use only a few features frequently, and use 
each feature in specific ways, PM Assistant quickly executes your 
favorite features and configures them to work the way you want. 

With PM Assistant you use hot-keys and buttons to perform 
common tasks. These buttons and hot-keys bring applications 
to the foreground, starting them if necessary. They execute 
menu commands, initialize or change the settings in dia¬ 
log boxes, copy data to and from the clipboard and 
among applications, and arrange your windows on the 
screen. It's like having a personal assistant doing the 
tedious elements of your job for you! 

Like an able assistant, PM Assistant can perform 
long, intricate procedures by combining all those types 
of tasks into powerful compound macros. Imagine 
typing your closure, printing, saving, and forwarding 
your document to your manager all with a single key¬ 
stroke or the press of a button! 

Now imagine performing tasks without even being 
there. With PM Assistant's task scheduler you can exe- 


1, Hot-key access to 

applications. 

2, Wndow placement 

3, Keyboard macros. 

4, Task scheduling. 

5, Screen Saver, 



cute macros arany’spccifte'Or recurring 
time. You can start programs, backup 
data, download files, begin long calcu¬ 
lations. pop-up reminders... at any time. 

The uses for PM Assistant are limit¬ 
less. You can execute macros indefb f 6, Ross 
nitely, and in random order. You can 

stress test applications. PM Assistant is ideal for VARS 
MIS administrators. You can integrate the power of several 
applications. You can distribute macro files to other users 
enabling them to complete complex tasks without 
knowing how , PM Assistant accelerates and Simplifies 
anyone’s work. 
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Object-Oriented Programming 


This article is excerpted with permission from Ciient/Server Survival Guide with OS/2 (VNH, March 
1994). 976pages. ISBN 0-442$1798-7. IBM Publication Number SR28-5494. 

By ROBERT ORFAU and DAN HARKEY 


Client/ Server 
Programming with 
CORBA Objects 








Robert Orfali 



O bject Request Brokers—or ORBs, 
as the natives call them—pro¬ 
vide the middleware that estab¬ 
lishes the client/server relationships be¬ 
tween objects. Using an ORB, a client 
object can transparently invoke a 
method on a server object, which can be 
on the same machine or across a net¬ 
work. The ORB intercepts the call and is 
responsible for finding an object that can 
implement the request, pass it the para¬ 
meters, invoke its method, and return 
the results, as illustrated in Figure 1. The 
client does not have to be aware of 
where the object is located, its program¬ 
ming language, its operating system, or 
any other system aspects that are not 
part of an object's interface. 



Figure 1 . The client/server request using the ORB 


THE STRUCTURE OF A CORBA ORB 

Clearly, we need standards for objects to 
interoperate in heterogeneous client/ 
server environments. Fortunately, this 
time around the industry anticipated this 
need, and the Object Management Group 
(OMG) was founded specifically to create 
distributed object standards before any 
major products were introduced—a truly 
amazing phenomenon. 1 OMG-compliant 
ORBs are commonly referred to as 
CORBA, which stands for Common 
Object Request Broker Architecture. 

Figure 2 shows the client and server 
components of a CORBA ORB. Even 
though there are many boxes, it is not as 
complicated as it appears. This section 
provides the big picture of what these 
components do. We go into more detail 
later. The key is to understand that 
CORBA, like SQL, provides both static 
and dynamic interfaces to its services. 
This is because OMG received two 
strong submissions to its ORB request 
for proposal: one from HyperDesk and 
Digital Equipment Corp. that was based 
on a dynamic API, and one from Sun 
and Hewlett-Packard that was based on 
static APIs. OMG told the two groups to 
come back with a single proposal that 
combined both features. The result was 
CORBA LI, The "Common" in CORBA 
stands for this two-API proposal. 
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Let's first go over the ORB compo¬ 
nents on the client side: 

• The client Interface Definition Lan¬ 
guage (IDL) stubs provide the static 
interfaces to object services* These 
precompiled stubs define how clients 
invoke corresponding services on the 
servers* The services are defined 
using the IDL, and both client and 
server stubs are generated by the IDL 
compiler* 

• The dynamic invocation APIs let you 
discover the method to be invoked at 
run time* CORBA defines standard 
APIs for obtaining the service defini¬ 
tions, generating the parameters, issu¬ 
ing the remote call, and getting back 
the results* 

• The interface repository APIs allow 
you to obtain descriptions of all the 
registered classes, the methods they 
support, and the parameters they 
require* CORBA calls these descrip¬ 
tions method signatures. The interface 
repository is a run-time database that 
contains a machine-readable version 
of the IDL-defined interfaces* The 
APIs let your programs access this 
information* 

• The ORB interface consists of a few 
APIs to local services that may be of 


interest to an application (for exam¬ 
ple, mapping object references to 
strings and vice versa). 

The client and server components 
communicate using the ORB core, which 
is implementation-specific (that is, not 
defined by CORBA)* The idea is that 
CORBA provides the interfaces above 
the ORB Core that mask the differences 
between vendor implementations* 
Vendors may use any transport they 
want for the networked ORB traffic and 
for the basic representation of objects in 
their system. Sun's DOE uses the ONC 
RPC over TCP/IP; HP's DOME uses 
DCE RPC; and IBM's DSOM supports 
sockets over TCP/IP, NetBIOS, or 
IPX/SPX (IBM is also working with HP 
on a DCE-based ORB). CORBA 2,0 (due 
late 1994) is working on a solution for 
multivendor ORB interoperability* The 
specification, however, should have 
minimal impact on CORBA 1,1 -compli¬ 
ant applications* 

CORBA-defined components ap¬ 
pear on the server side between the ORB 
core and the object implementations* 
Here's a quick explanation of what the 
pieces do: 

* The server IDL stubs (also known as 
skeletons) provide the static interfaces 
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Figure 2. Structure of a CORBA ORB 
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to each service exported by the 
server. These stubs, like the ones 
on the client, are created using 
the IDL compiler The server 
cannot tell the difference 
between incoming static or 
dynamic invocations. They're 
both invoked through server 
stubs. 

The object adapter interfaces 
with the ORB's core communica¬ 
tion services and accepts 
requests for service on behalf of 
the server's objects. It provides 
the run-time environment for 
instantiating server objects, pass¬ 


ing requests to them, and assign¬ 
ing them object IDs—CORBA 
calls them object references. The 
object adapter also registers the 
classes it supports and their run¬ 
time instances (that is, objects) 
with the implementation reposi¬ 
tory. CORBA specifies that each 
ORB must support a standard 
adapter called the basic object 
adapter. Servers may support 
more than one object adapter. 

* The implementation repository 
provides run-time directory 
information about the classes a 
server supports, the objects that 
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Figure 3. The ORB-based static and dynamic invocation services 
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Figure 4. Defining services : from IDL to interface stubs 


are instantiated, and their IDs. It 
also serves as a common place to 
store additional information 
associated with the implementa¬ 
tion of ORBs. Examples include 
trace information, audit trails, 
security, and other administra¬ 
tive data. 

This concludes our panoramic 
overview of the ORB components 
and their interfaces. If you are con¬ 
fused, keep reading—the next 
level of detail may help clarify 
things, 

CORBA CLIENT/SERVER REQUESTS 

Figure 3 shows the two types of 
client/server invocations that are 
supported by a CORBA ORB: sta¬ 
tic and dynamic. In both cases, the 
client performs a request by hav¬ 
ing access to an object reference 
(that is, object ID) and invoking 
the method that performs the ser¬ 
vice. The dynamic and static inter¬ 
faces for performing the service 
satisfy the same request semantics. 
The receiver of the message cannot 
tell how the request was invoked. 
In both cases, the ORB locates a 
server object adapter, transmits the 
parameters, and transfers control 
to the object implementation 
through the server IDL stub (or 
skeleton). 

Clients see the object interfaces 
through the perspective of a lan¬ 
guage mapping—or binding—that 
brings the ORB right up to the pro¬ 
grammer's level. Client programs 
should be able to work without 
any source changes (on any ORB 
that supports the language bind¬ 
ing) with any object instance that 
implements the interface. The im¬ 
plementation of the object, its ob¬ 
ject adapter, and the ORB used to 
access it is totally transparent to 
both static and dynamic clients. 

THE CORBA PROCESS: FROM 
IDL TO INTERFACE STUBS 

Figure 4 shows the steps you go 
through to create your server 


48 


OS/2 DEVELOPER 
































































































The Object People 

Your Smalltalk Experts 


smai 




VISIT US 
at OOPSLA 
Booth #606/608 




Education 8c Training 

Smalltalk/V 
VisualWorks 
VisualAge 
ENVY/Developer 
Analysis 6c Design 
Project Management 
In-House 6c Open Courses 

Project Related Services 

Object Immersion Program 
Project Mentoring 
Custom Software Development 
Legacy Systems 
GUI’s, Databases 
Client-Server 


■■ 


The Object People Inc. 509-885 Meadowlands Dr., Ottawa, Ontario, K2C 3N2 
Telephone: (613) 225-8812 FAX: (613) 225-5943 



Smalltalk/V is a registered trademark of Digitalk, Jue* 
VisualWorks is a trademark of Parcllacc Systems Inc. 


VisualAge is a registered trademark of IBM 
BNVY is a registered trademark of OH Inc. 




















classes, provide interface stubs for 
them, store their definitions in the 
interface repository, instantiate the 
objects at run time, and record 
their presence with the implemen¬ 
tation repository. Let's go through 
these steps one by one and see 
what is involved. 


1, Define your object classes 
using IDL. IDL is the means by 
which objects tell their potential 
clients what operations are avail¬ 
able and how they should be in¬ 
voked, The IDL definition lan¬ 
guage defines the types of objects, 
their attributes, the methods they 
export, and the method parame¬ 
ters. The CORBA IDL is a subset of 
ANSI C++ with additional con¬ 
structs to support distribution. IDL 
is purely a declarative language. It 
uses C++ syntax for constant, type, 
and operation definitions; how¬ 
ever, it does not include any con¬ 
trol structures or variables. 


2. Run the IDL file through a lan¬ 
guage precompiler , A typical 
CORBA-compliant precompiler 
processes the IDL files and pro¬ 
duces C or C++ language skeletons 
for the implementation server 
classes. 

3. Add the implementation code to 
the skeletons. You must supply the 
code that implements the methods 
in the skeletons. In other words, 
you must create your server 
classes. 

4. Compile the code. A CORBA- 
compliant compiler is typically ca¬ 
pable of generating at least four 
types of output files: 

• Import files that describe the 
objects to an interface repository 

• Client stubs for the IDL-defined 
methods—these stubs are in¬ 
voked by a client program that 
needs to statically access IDL- 
defined services via the ORB 

• Server stubs that call the meth- 


ORB vs. RPC 


“Brokers of all types—stock brokers as well as object brokers—exact a 
price for their services." 

Bill Andreas, 

Chief-Architect, HyperDesk 

How are ORB method invocations different from RPCs? The mecha¬ 
nisms are very similar, but there are some important differences. With 
an RPC, you call a specific function (the data is separate). In contrast, 
with an ORB, you're calling a method within a specific object. Different 
object classes may respond to the same method invocation differently 
through the magic of polymorphism. Because each object manages its 
own private instance data, the method is implemented on that specific 
instance data. 

ORB method invocations have "scalpel-like" precision—-the call gets to 
a specific object that controls specific data and implements the function 
in its own class-specific way. In contrast, RPC calls have no speci¬ 
ficity—all the functions with the same name get implemented the 
same way. No differentiated service here. Of course, the ORB is usually 
built on top of an RPC service, so you end up paying a performance 
penalty for this "refined" level of service. It is worth every penny if 
you're taking advantage of new levels of distributed granularity pro¬ 
vided by objects. Otherwise, you just bought yourself another layer of 
middleware—with all the costs and headaches that come with it. 


ods on the server—they're alst 
called up-call interfaces 
• The code that implements th< 
server classes. 

The automatic generation o 
stubs frees developers from havinj 
to write them and frees applies 
tions from dependencies on a par 
iicular ORB implementation. 

5. Bind the class definitions to th 
interface repositorx/. Typically a uti! 
ity is provided to bind—or, if yoi 
prefer, compile—the IDL informa 
tion in a persistent store that car 
be accessed by programs at rui 
time. 

6. Instantiate the objects on tk 
server. At startup time, a serve 
object adapter may instantiati 
server objects that service remoti 
client method invocations. Thesi 
run-time objects are instances o 
the server application classes 
CORBA specifies different objec 
adapter strategies that are used h 
create and manage the run-tim 
objects. 

7. Register the run-time object 
with the implementation repositon 
The object adapter records in th 
implementation repository the ot 
ject reference and type of any ot 
ject it instantiates on the serve 
The implementation repositor 
also knows which object classc 
are supported on a particuls 
server. The ORB uses this inform; 
tion to locate active objects or to n 
quest the activation of objects on 
particular server. 

The seven steps we just ou 
lined are typical of most CORB 
implementations* CORBA, < 
course, allows deviations. For e 
ample, it is not a requirement fi 
IDL source code to be available , 
long as the interface information 
available in stub form or in an i 
terface repository. It is not nece 
sary for the server objects to be if 
plemented as classes as long 
they are encapsulated by II 
stubs. The separation of the inh 
face from the implementatii 
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f When you’re pressing the limits of soft- 
ware performance, every microsecond 
counts. Efficient operation decreases exe¬ 
cution time, putting you ahead of the pack. 

That’s why professional C/C++ developers 
use High C/C++'. MetaWare’s High C/C++ com¬ 
pilers offer eight levels of global optimization, plus 
specific optimizations for particular processors. The 
executables consistently out-perform competitors in 
benchmark testing. 

Besides offering rapid execution time, 
MetaWare’s High C/C++ compilers provide a myriad 
of controls that allow you to customize and fine-tune 
code generation. There are command-line toggles 
and pragmas for customizing your application. 



The compilers generate informative error and warning 
messages, and comply with major industry standards. 
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metaware.com, for more information about features 
and specific platforms. 
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makes it possible to incorporate 
existing (legacy) systems within an 
ORB environment. 


HOW METHODS ABE 
DYNAMICALLY INVOKED 

CORBA's dynamic invocation 
APIs allow a client program to dy¬ 
namically build and invoke re¬ 
quests on objects. The client speci¬ 
fies the object to be invoked, the 
method to be performed, and the 
set of parameters through a call or 
sequence of calls. The client code 
typically obtains this information 
from an interface repository or a 
similar run-time source. The dy¬ 
namic invocation provides maxi¬ 
mum flexibility by allowing new 
object types to be added to the dis¬ 
tributed system at run time. Visual 
tools will use this API to create in¬ 
terfaces through point-and-click 
interactions with a user 


To invoke a dynamic method 
on an object, the client must per¬ 
form the following steps, which 
are shown in Figure 5: 

1. Obtain the method description 
from the interface repository. CORE A 
specifies about 10 calls for locating 
and describing objects within the 
repository. After an object is lo¬ 
cated, a describe call is issued to ob¬ 
tain its full IDL definition. 

2. Create the argument list . 
CORBA specifies a self-defining 
data structure for passing parame¬ 
ters, which it calls the NamedYalue 
list. The list is created using the 
createJ_L$t operation and as many 
add.arg calls as it takes to add each 
argument to the list. 

3. Create the request. The re¬ 
quest must specify the object refer¬ 
ence, the name of the method, and 
the argument list. The request is 
created using the CORBA 


Client Object 

Obtain Object Description 

iookup^name () 
describe 0 

Create Object List 

create JList {) 

addarg ()...add_arg (),..addjirg 0 

^ 1 * 


Three 
wavs oi 
doing 
Remote 




Create this Request 

create_request (Object Reference, 
Methods, 
Argument List) 


Invoke the Remote Method 


Using RPC 
or 

Send/Receive 

or 

Datagram 


send () 
get,response 
send () 
"one ms f 


Figure 5 . The CORBA dynamic invocation interface 


create_request call. 

4. Invoke the request . The re¬ 
quest may be invoked in one of 
three ways: 

* The invoke call sends the request 
and obtains the results. 

* The send call returns control to 
the program, which must then 
issue a get_response or 
get.next.response call. 

* The send call can be defined to be 
"one way"; in this case, no re¬ 
sponse is needed. 

As you can see, it takes effort 
to dynamically invoke a method. 
You're trading off complexity and 
performance for added flexibility. 

STATIC VS. DYNAMIC 
METHOD INVOCATIONS 

The static interface is directly gen¬ 
erated in the form of stubs by the 
!DL precompiler. It is perfect for 
programs that know at compile 
time the particulars of the opera¬ 
tions they will need to invoke. The 
static stub interface is bound at 
compile time and provides the fol¬ 
lowing advantages over the dy¬ 
namic method invocation: 

* It is easier to program. You call 
the remote method by simply 
invoking it by name and passing 
it the parameters. It's a very nat¬ 
ural form of programming. 

* It provides more robust type 
checking. The checking is 
enforced by the compiler at 
build time. 

* It performs well. A single API 
call is issued to the stub, which 
takes it from there. 

* It is self-documenting. You can 
tell what's going on by reading 
the code. 

In contrast, the dynamic 
method invocation provides a 
more flexible environment. It al¬ 
lows you to add new classes to 
the system without requiring 
changes in the client code. It is 
very useful for tools that discover 
what services are provided at run 
time. You can write some very 
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generic code with dynamic APIs. 
However, most applications do 
not require this level of flexibility 
and are better off with static stub 
implementations. 2 
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Object-Oriented Programming 


This article shows you how to contract visual wrappers for existing APIs by using 
Smalltalk, By ROBERT LINDSA Y 


Visual Age, IBM's new 


Hints for VisualAge 
Wrappers 


M W ecently, I was part of a team at 
AMS that used IBM's new ob- 
■ ■ |ect-oriented application devel¬ 
opment tool, VisualAge. This product 
supports a visual programming inter¬ 


face and allows IBM Smalltalk to be 
used for nonvisual components* Our 
project created a visual parts library by 
building a set of wrappers for an exist¬ 
ing subsystem* The visual parts library 
allows application developers to use the 
services of the subsystem through visual 
programming. 

Although many features of 
VisualAge deserve mention, our inten¬ 
tion here is to provide some hints on 
how to successfully construct visual 



Figure 1, Wrappers build encapsulation 


wrappers for existing API's. In this man¬ 
ner, you can extend the usefulness of 
your current subsystems into the visual 
programming domain. 

WRAPPERING 

Figure 1 indicates the basic theory be¬ 
hind building wrappers. An interface 
object is constructed to provide encap¬ 
sulation and isolation between the ob¬ 
ject-oriented application and a proce¬ 
dural subsystem* Through isolating 
low-level services and interfaces, wrap¬ 
pers provide useful building blocks for 
the object-oriented programmer* 
Wrappers also limit the exposure of the 
interface to the internals of a single ob¬ 
ject and thereby promote reuse* On the 
downside, wrappers may not provide as 
balanced a partitioning of function as a 
completely object-oriented design. 

In the VisualAge environment, vi¬ 
sual wrappers need to provide a slightly 
larger service, that of being a useful vi¬ 
sual building blocks. This requires a 
modified approach to usual object-ori¬ 
ented construction techniques because 
visual building blocks communicate 
through events connected to actions. 
Nonvisual object-oriented systems nor¬ 
mally communicate via messages be¬ 
tween objects* Although this may seem 
to be splitting hairs, the difference gives 
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the application programmer an orienta¬ 
tion toward either real-time asynchro¬ 
nous processing or controlled synchro¬ 
nous processing. 

In this article, we will focus on a 
simple example: a wrapper that allows a 
programmer to visually use logon/log¬ 
off services invoked via C function calls. 
This is a very small portion of the func¬ 
tionality available through using wrap¬ 
pers and should not be considered as 
even typical of the complexity of normal 
wrappers. It will illustrate our major 
points, however: 

• A modified form of CRC may be used 
to design parts. 

• Visual building blocks should be visu¬ 
ally proofed. 

• Low-level interfaces can be easily 
wrapped. 


MODIFIED CRC 

In our project, we started by first design¬ 
ing what our visual parts library would 
look like. In so doing, we constructed re¬ 
quirements from various uses of the 
parts. We then built "paper" parts and 
performed CRC modeling—a standard 
object-oriented design technique—to de¬ 
termine if our organization of the parts 
was correct. 

CRC is a technique for validating a 
proposed clustering of functionality into 
objects, by reviewing the responsibilities 
and dependencies of each object via a 
role playing process. In the course of 
doing CRC, the balance of behavior as¬ 
signed to objects becomes apparent, so 
CRC facilitates a well-balanced design 
of objects. CRC also provides a docu¬ 
mentation method for the eventual ob- 



Figure 2. Mock nonvisual part components 
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ject messages and attributes. 

Because of the event-oriented 
nature of VisualAge programming, 
we have discovered that a modified 
form of CRC can work better. In the 
modified form, we list EVENTS in ad¬ 
dition to ACTIONS and ATTRIBUTES. This 
modification allows for a more ex¬ 
plicit paper representation of the 
functional nature of the part and 
provides a better indication of the 
actual role played by the parts in 
implementing an application. 

THE VISUAL PROOFING 

Because the parts need to be visu¬ 
ally useful, in addition to using a 
modified CRC, it is also advisable 
to create mock components and 
role-play the use of the parts visu¬ 
ally to determine if the correct bal¬ 
ance between functionality, flexibil¬ 
ity, and form have been achieved. 
This is done by creating mock parts 
in VisualAge and building several 
prototype uses of the part. 

Constructing mock parts with 


VisualAge is straightforward. The 
parts designer can build these 
parts in a few minutes and place 
them onto a visual palette. By pro¬ 
viding dummy placeholders of 
various types, mock parts can be 
given attributes. Events and ac¬ 
tions can also be built into mock 
parts so they appear to act com¬ 
plete, as shown in Figures 2 and 3. 

When mock parts are assem¬ 
bled into a mock application, it be¬ 
comes easy to identify (if the cor¬ 
rect level of parts design has been 
achieved) even though no real 
code has been constructed, as 
shown in Figure 4. Because of the 
nature of visual programming, 
some idea of how parameters af¬ 
fect behavior needs to be ad¬ 
dressed. For basically static para¬ 
meters, a notebook control for the 
part itself is ideal, allowing the 
programmer to specify values at 
part selection time. For more dy¬ 
namic parameters, explicit attrib¬ 
utes will need to be defined, and 


script language (Smalltalk-like) 
may need to be written. 

At this point, it is a good idea 
to document and review the steps 
that were required to use each part 
to determine if the use is awkward 
or natural. Ideally, a programmer 
should find the composition of 
parts is intuitive, although this 
may be difficult to get exactly cor¬ 
rect when building wrappers. If 
the parts are built along subsystem 
functional groupings (for example, 
I/O operations together in a logi¬ 
cal I/O object), it may require 
some hidden classes to support 
shared data items, but the pro¬ 
grammer will have a reasonable vi¬ 
sual metaphor for the underlying 
subsystem. 

When we did this exercise for 
our subsystem wrappers, we 
found that fewer, more monolithic 
parts with several modes of opera¬ 
tion were easier to use in building 
applications than a lot of small 
parts that had to be assembled 



Figure 3. Mock visual part components 
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Figure 4 , Prototype application using mock parts 



Figure 5 , A coroutine call 



Figure 6. A primitive-level direct call 


over and over by the application 
programmer. 

After the visual design exer¬ 
cise, the mock parts can be turned 
over to a parts artist who can then 
create the desired visual represen¬ 
tation of the underlying function¬ 
ality through good icon design, 

LOW-LEVEL INTERFACES 

While most of the development ef¬ 
fort under VisualAge is straightfor¬ 
ward, one low-level situation may 
require caution. A typical interface 
from Smalltalk to C is shown in 
Figure 5. This interface builds a pa¬ 
rameter list and then invokes C 
using built-in IBM Smalltalk func¬ 
tions. Coroutines are used because 
they allow the visual components 
to proceed even if the invoked ser¬ 
vices consume substantial CPU cy¬ 
cles or have blocked threads. This 
is normally a good default method 
to invoke low-level services. 

In some cases, however, you 
need to be careful when invoking 
low-level services using corou¬ 
tines, These are the calls that may 
have their own multithreaded 
structure internal to the API. For 
some of these APTs, control may 
return to Smalltalk (which will ter¬ 
minate the extra coroutine thread) 
before the internal threads have 
completed. The results are then un¬ 
predictable. 

To avoid this situation, invoke 
services that create additional in¬ 
ternal threads using a simple call 
interface, as shown in Figure 6 (an 
illustration of using a Smalltalk 
primitive to call a C interface), 

CONCLUSION 

VisualAge's ability to allow the 
rapid prototyping of systems, fol¬ 
lowed by the construction of the 
underlying components, proves to 
be of great value. We were able to 
rapidly assess the ease of use of our 
proposed visual parts with only a 
minima! construction effort. Once 
we had verified the design of our 
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visual parts and that they would be 
easy to use in building the desired 
systems, we found that fewer more 
monolithic, parts with several 
modes of operation were easier to 
use than a lot of small parts. 

This article has presented 
some of the considerations for 
constructing VisualAge wrappers 
for existing services. I would like 
to thank Gordon Sheppard of 
AMS for his ideas and contribu¬ 
tions in the areas of event-based 
CRC and other topics* Hopefully 
this brief introduction to 
VisualAge wrappers will assist 
others in building visual program¬ 
ming environments* 
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Object-Oriented Programming 



Always wanted to write PM controls but felt it was too much work? Here is a way to alleviate the pain 
of window proc development using C++ and the IBM Class Library, By ERIC SNELL and LORI RUFFING 


Writing OS/2 PM 
Controls in C++ 


he traditional way to write OS/2 
Presentation Manager window 
controls has been to use C and 
write a window procedure that consists 
of one large case statement. Any reuse 
was obtained by a small amount of copy 
and pasting in an editor, but, for the 
most part, each new control was basi¬ 
cally created from scratch* When pro¬ 
gramming in a C++ environment; this 
does not seem to be the correct way to 
develop new controls: first writing a C 
control and then wrapping the new con¬ 
trol in C++, This article describes a 
method of writing new Presentation 
Manager controls in C++ and using in¬ 
heritance to greatly aid reusability. 

GETTING STARTED 

When writing a C++ class, our first in¬ 
stinct is to ask: From what class can I in¬ 
herit to get the basic functionality re¬ 
quired? Using the user interface library 
shipped with C Set++, a likely candidate 
as parent of a new control would be the 
ICafivas class. After using ICanvas as the 
parent for several controls, we came to 
the conclusion ICanvas was best suited 
for static controls due to its implementa¬ 
tion, The problems with inheriting from 
ICanvas are as follows: 

* Class style bits, such as CS.PAREMTCLIP, 
can cause unexpected problems* 


* Specific class style bits cannot be set 
since the class is already registered* 

* It is difficult to determine what mes¬ 
sages should be allowed to fall 
through to the canvas. For example, if 
the canvas sees it is receiving the 
focus, it will give the focus to another 
window. 

* Handlers cannot distinguish between 
subclasses of ICanvas since al! sub¬ 
classes have tfCSTATIC as their class 
name. 

* VW.CONTROL messages will collide. This is 
related to the previous problem. 

To address these problems, a class 
specifically designed as a base for new 
controls was needed. 

AN ABSTRACT WINDOW CLASS 

The base class we developed for new 
controls, lAbstractyindoy, needed to regis¬ 
ter a new window class with Pre¬ 
sentation Manager to meet some of our 
design criteria dealing with notifica¬ 
tions* A class name, class style, amount 
of extra window words, and a pointer to 
a window procedure function are 
needed for window class registration 
(see WinRegisterClass)* Subclasses of 
lAbstractWindoy supply most of this infor¬ 
mation during construction, and 
IAbstractWindov performs the registration. 
lAbstraetWindov also accepts the stan- 



SEPTEM8ER/0CT0BER 19 9 4 














m 


dard ICLUI window creation para¬ 
meters during construction: win¬ 
dow ID, parent window, owner 
window, initial size and position 
rectangle, and window style bits. 
This is so IAbstractYindow can create 
the window and subclass it using 
the IVindov::startHandllngEventsFor 
method. The constructor registers 
the new class with Presentation 
Manager if it isn't already regis¬ 
tered through a previous invoca¬ 
tion, constructs the window using 
the IWindow::create method, and 
subclasses the window and adds 
various default handlers, as shown 
in Figure 1. 

ICLUI presents the concept of 
handlers, which are classes whose 
purpose is to receive Presentation 
Manager messages and invoke vir¬ 
tual functions based on the message 
content. ICLUI subclasses the de¬ 


fault Presentation Manager win¬ 
dow procedure of a control with the 
IWindow: :startHandHngEvent&For meth¬ 
od. When a Presentation Manager 
message is received, ICLUI calls a 
list of handler classes invoking the 
IHandler: rdispatchHandlerEvent meth¬ 
od. Each handler is added to the 
window's handler list when it is 
registered with ICLUI by calling 
IHandler::handleEvent$For. It is the 
dispatchHandlerEvent method that will 
examine each message and invoke 
a virtual function in the handler if 
the message is recognized. 

Since the newly registered 
Presentation Manager class will 
immediately be subclassed, we can 
pass HinOefWindowProc as the window 
procedure for all of IAbstractWindov's 
subclasses. The functionality 
unique to each window is imple¬ 
mented by overriding the virtual 


functions associated with the han¬ 
dler classes. Each message that is 
not handled will eventually be 
passed on to WinDefWindovProc, just 
as in the traditional C window^ 
procedure. 

Default Behavior. Since Pre¬ 
sentation Manager windows share 
many of the same characteristics, 
IAbstractYindow is a good place to 
implement much of the functional¬ 
ity common to well-behaved con¬ 
trols. For example, each window 
should send its owner a WH_CONTRQL- 
POINTER message when the mouse 
pointer is over the window. This 
functionality is implemented in 
lAbstractWindow in the inouseMove 
method and is, therefore, in all 
subclasses of lAbstractWindow. If a 
subclass needs to do further pro¬ 
cessing during a mouse move, the 
subclass overrides rttouseHove, calls 
its parent's (nouseHove method, and 
performs any processing specific to 
the subclass. 

The set of all messages to 
which well-behaved controls 
should respond could be handled 
in IAbstractYindow, Responding to 
messages such as WH_HATCHMNEMONIC 
and WH.QUERYDIALOGCOOE can be imple¬ 
mented as virtual functions and 
overridden in subclasses as 
needed. This implementation of 
UbstractYindow may not be com¬ 
plete based on some certain design 
criteria, but it has enough func¬ 
tionality to allow a subclass to be 
quickly developed. All that is 
needed is a constructor and de¬ 
structor in the subclass. 

Many handlers are provided 
in the ICLUI class library, but not 
every Presentation Manager mes¬ 
sage is covered. It was necessary 
for us to write a handler that 
would cover some of the func¬ 
tionality we wished to provide. 
Most handlers group together a 
set of closely related messages; 
whereas the handler we wrote, 
lAbsWinHandler, seems to have totally 
unrelated messages. Since these 



Figure f. Constructor for IAbstractVindov 
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messages are unlikely to be used 
outside IAbstractWindow or its sub¬ 
classes, we decided one handler 
would suffice. This example does 
not illustrate a complete list of 
messages to which a control 
should respond. We recommend 
that a production version of 
IAbstractWindow provides the com¬ 
plete default behavior of a well-be¬ 
haved Presentation Manager con¬ 
trol. This allows for fast, iterative 
development of Presentation 
Manager controls. 

A NEW CONTROL 

Now that we have a base class, de¬ 
veloping Presentation Manager 
controls should be relatively 
straightforward. The first and easi¬ 
est step is to write the constructor 
and destructor of the new control. 
Being consistent with ICLUI's win¬ 
dow constructors, our example 
control (surprisingly called 
NewControl) takes the familiar win¬ 
dow creation parameters. Figure 2 
shows how the constructor simply 
passes the information, along with 
window class parameters, to 
IAbstractWindow. IAbstractWindow does 
all the underlying work and sup¬ 
plies enough default behavior so 
we now have a new Presentation 
Manager control. 

Window Styles. NewControl is 
relatively uninteresting with 
only a constructor, so let's exam¬ 
ine the steps taken to start refin¬ 
ing the window's behavior. The 
next step will be to define any 
style bits the control will have 
and allow for access and manip¬ 
ulation of these styles. The macro 
INESTEOBITFLAGCLASSDEFx allows you 
to define a nested BitFlag subclass 
and specify the name of the class 
associated with and scoping the 
BitFlag class being declared. 
NewControl names the nested class 
Style and also specifies that IControl 
and IWindow styles can be combined 
with NewControl's styles. Another 
macro, INESTEOBITFLAGCLASSFUNCS, de¬ 


fined outside the class declaration, 
defines the operations that can be 
performed on the nested Style 
class. 

A window class should define 
a public, static, constant Style vari¬ 
able, dassDefaultStyle, which holds 
the initial default window styles. It 
also should define a private, static 
Style variable, currentDefaultStyle, 
which the user can access to 
change the default style. Class 
methods setDefaultStyle and 
defaultStyle allow the user to set 
and query the class's default style. 
The defaultStyle method supplies a 
default value for the NewControl con¬ 
structor. The setDefaultStyle meth¬ 
od is useful when the user wants 
to create several controls whose 
styles are similar but differ from 
the original class default style. 

The individual styles them¬ 
selves are declared as static, con¬ 
stant Style class members in the 
public section of the class declara¬ 
tion. NewControl declares the styles 
notifyMBl and notifyMB2. The styles 
of NewControl determine if notifica¬ 
tions about mouse button clicks 
are sent to the owner of the con¬ 
trol. These members can be refer¬ 
enced and combined by users of 
the class to affect the control's be¬ 
havior. Care should be taken so the 
chosen style bits do not conflict 
with predefined Presentation 
Manager style bits. 


Since dassDefaultStyle and 
currentDefaultStyle are class vari¬ 
ables, initial values must be 
assigned to them. The 
dassDefaultStyle is set to some com¬ 
bination of Style variables as de¬ 
clared by the classes referenced in 
INESTEDBITFLAGCLASSDEF2. The initial 
value of currentDefaultStyle is set to 
dassDefaultStyle. The user can now 
reference the style constants of the 
class and treat them like bit flags. 
An added bonus is that the styles 
are scoped to the class and their 
meaning is much more obvious. 

Painting the Control. IAbstractWindow 

subclasses need only override the 
paintWindow method to paint the 
window in response to paint mes¬ 
sages. NewControl simply paints 
some text in the center of the win¬ 
dow, which displays how many 
times mouse button one has been 
clicked in the window. Although 
NewControl's paint routine is simple, 
it has much functionality due to its 
use of presentation parameters. 

Window controls should base 
the colors they use for painting on 
colors obtained through presenta¬ 
tion parameters defined by 
Presentation Manager. This allows 
easy control of the colors in a pre¬ 
defined way. In fact, drag-and- 
drop from the color and font 
palettes are based on presentation 
parameters. The presentation 


NewControl::NewControl(unsigned long id, 

IWindow* parent, 

IWindow* owner, 

const IRectangle* initial, const 
Style* style) 

: IAbstractWindow (newControlQass, newControlCLassStyle, 

0 , 

id, 

parent, 

owner, 

initial, 

style.asUnsignedLong()), 


Figure 2. Constructor for NewControl 
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Now you can access 
the most comprehensive, 
detailed listings of vendors 
and applications serving 
the OS/2 market — all from 
one source: the IBM OS/2 
APPLICATIONS DIRECTORY. 

This is the complete guide to solu¬ 
tions for even the most special¬ 
ized applications. It keeps devel¬ 
opers up to date on the competi¬ 
tion and end-users up to speed on 
what's available and where to 
find it. 

The 270-page directory gives you 
fully detailed listings that include: 

• Company name 

• Contact name 

• Address 

• Phone number 

• Product description 

• Details on software features 

• Price 

• Availability date 




Applications are conveniently 
organized by 17 general industry 
categories in alphabetical order: 

• Accounting/personal finance 

• Business-specific 

• CAD/CADAM 

• Communications 


• Database 

• Development tools 

• Electronic mail 

• Games/entertainment 

• Graphics / Desktop Publishing 

• Information management 

• Integrated workgroup 

• Networks 

• Spreadsheets 

• Utilities 

• Word processing 

ftlui you cjet: 

• index of vendors, cross-refer¬ 
enced by product name 

• Special separate section of 
applications certified by IBM's 
Ready! for LAN Server certifi¬ 
cation program 

Make your solutions- 
search easy. 

Send for the IBM OS/2 APPLICATIONS 
DIRECTORY 

OS/2 is a registered trademark of IBM Corp. 


rilNLY $9.95 FOR BOOK. $19.95 FOR CD-ROM ~j 

I cm Book $9.95 I I cP-ROM $19 35 [ I floth $25.00 I 
I Please indicate number of books or CDs desired. ■ 

1 US$1 shipping/handfing for CO ROM. US$3 50 shipping/handting for book, | 

| US$4.50 shipping/handling for CD-ROM and book. Please add USS2 for shipping to | 

I Canada and overseas. i 

| □ Payment enclosed (include sales tax in CA. GA P IL, MY & TX; GST m Canada) t 

I □ Charge my: □ Visa □ MasterCard □ American Express I 

I Card# ___ Exp, date I 


| Name ___ 

I Title __ 

- Company ______ 

| Address ____ 

I Citv/State/Prov. _____ 

■ Zip/Postal Code _ Country 

i Phone _ FAX 

I Signature (REQUIREDI ___ 

| Attn: OS/2 Applications Directory 
| Snyder/IMewell Inc. P 0 Box 7046. San Fransisco, CA 94120 
• Calf: (800) 444-4881 toll free, or (415) 826-7170 
or fax Th i s orde r to: (415) 826-7378 























space obtained from 
IPaintEvent: ;presSpaceHandle already 
has the background and fore¬ 
ground colors established from 
any previously set presentation pa¬ 
rameters; so, basing any other col¬ 
ors on presentation parameters is a 
natural extension. Painting is not 
always done in response to paint 
messages, and some methods de¬ 
fault color parameters to specific 
colors; so explicitly retrieving pre¬ 
sentation parameters is good prac¬ 
tice (your code is also very explicit 
with its intentions). 

IWindov has two methods, color 
and setColor, which set specific col¬ 
ors into the window's presentation 
parameters. The problem with 
using these methods directly is 
they take unsigned long parame¬ 
ters to represent the presentation 
parameters. This is not very mean¬ 
ingful to the user unless he or she 
does a search of PMUIN.H. It is better 
to define an enumeration that con¬ 
tains all the colors meaningful to 



the control. NewControl defines an 
enumeration. Color Area, which con¬ 
tains the item's background, fore¬ 
ground, and hilite. This allows the 
user to be very sure of exactly 
what color area he or she intends 
to set without confusion or mis¬ 
take, and, of course, the code is ex¬ 
tremely readable since we provide 
a specific type related to our class 
and not an obscure macro- If you 
set the value of the enumeration 
members to the presentation para¬ 
meters, it makes the code simple 
and straightforward. Figure 3 
shows the ColorArea enumeration 
and the methods dealing with the 
color presentation parameters. 

NewControl also calculates the 
size and position of displayed 
text each time the control paints. 
Therefore, the user can drag and 
drop a font onto the control, and 
the control will handle the 
change properly. lAbstractUindow's 
presPa ramCfianged method is invoked 
whenever a presentation parame¬ 


enum ColorArea 
{ 

background * 3, II PPJACKGROUNDCOtOR 

foreground =1, II PP,FOREGROUHDCOLOR 

hilite = S // PPJUnEFOREGROUNDCOLOR 

NewCentroll NewControl::setColor(ColorArea area, const IColor^ color) { 
Window::setColor(area, color); 
return *this; 

} 

IColor NewControl::color(ColorArea area) const 
{ 

return XWindow::color(area); 

> 

Boolean NewControl::p3intWindow(IPaintEvent& evt) 

establishColoKclrBackground, background, defclrBackground); 
establishColor(clrForeground, foreground, defdrForeground); 
establishColor (cirHilite, hilite, defdrHilite); 


Figure 3 : Color enumeration and methods 


ter changes, and its response is to 
invalidate the window rectangle so 
the changes will be displayed. A 
subclass may wish to override this 
method to do such things as cache 
color values, precalculate text size 
and position, or alter its minimum 
size. 

EVENT NOTIFICATION 

Most window controls notify their 
owners of significant events 
(whether or not an event is signifi¬ 
cant is defined by the control). The 
architected method for owner noti¬ 
fication in Presentation Manager is 
the WH_CGNTRGL message. It is a good 
idea to use the WN_CQNTRGL message 
for owner notifications since we do 
not know how our control will be 
used in the future, and this is the 
documented method. Also, we 
would not want to confuse our 
owner by possibly duplicating an¬ 
other message. 

NewControl will notify its owner 
of mouse button one and mouse 
button two clicks based on the set 
style bits. The iyindow: :sendEver?t 
method makes it easy to package 
this event and send it to the owner. 
We could leave it at that, forcing 
the user to understand how the 
message is encoded, but it is much 
better to wrap the message in an 
event and provide a specific han¬ 
dler to catch the event. 

BtvContnd Event Wrapping a 
specific WN_CGNTROL event has al¬ 
ready partially been done for us* 
The IControlEvent class understands 
the part of a HM.CONTROL message 
that is not specific to a window 
class. IControlEvent provides a 
method to determine the ID of the 
window that sent the message and 
also a method to return an iyindow 
pointer to the window. It is up to 
us to subclass IControlEvent to pro¬ 
vide the methods specific to the 
NewControlEvent class. 

While writing event classes for 
the various controls we are imple¬ 
menting, we found some common 
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functions duplicated among the 
various classes. For a WM_C0NTR0L 
handler to properly determine 
which virtual function to invoke, if 
any, it must know the Presentation 
Manager class name of the control 
that sent the message. An applica¬ 
tion knows the control by its ID, 
but in the context of a handler, an 
ID is not meaningful. For example, 
a NewControIHandler must know that 
an event was received from a 
NewControl window, and the only 
way this can be determined is by 
the class name. This called for a 
new base class for our VM.CONTRGL 
message wrappers, HControlEvent. 

MControlEvent provides two 
more methods, controlHandle and 
controlCLassNafne. The coatrolCLassName 
method will be used in each of the 
handlers we write, including 
NewControlHandler, to match the win¬ 
dow class originating the notifica¬ 
tion to the handler. Now that the 
window class can be identified, 
NeuControIEvent is easily completed, 
NewControlEvent simply provides a 
method, mouseNumber, to extract the 
information NewControl encoded in 
the message. 

towCo/ttroJ. Handler* A handler 
class provides a set of virtual 
methods that are invoked based on 
certain Presentation Manager mes¬ 
sages. ICLU1 invokes the handler's 
dispatchHandlerEvent method when a 
Presentation Manager message is 
received. The dispatchHandlerEvent 
determines if it recognizes the 
message, possibly constructs a spe¬ 
cific event, and invokes a virtual 
function declared by the handler. 

NewControlHandler is a handler 
designed to filter WLCONTROL mes¬ 
sages sent from a NewControl win¬ 
dow. The dispatchHandlerEvent 
method ensures the sender is a 


NewControl and calls the appropriate 
NewControlHandler method. An appli¬ 
cation uses this class by adding it 
to the handler list of the owner of a 
NewControl window. This is the pur¬ 
pose of the IHandler::handleEventsFor 
method. The user overrides the 
virtual function related to the mes¬ 
sage to be examined. When that 
message is received, the user's 
method is invoked. 

CONCLUSION 

The NewControl example presented 
here is a simple control but pre¬ 
sents many techniques that can be 
used to simplify and speed devel¬ 
opment of Presentation Manager 
window controls. A few well-de¬ 
signed base classes will encourage 
development of new Presentation 
Manager classes where developers 
may have been hesitant. The de¬ 
fault functionality of base classes 
gives subclasses a large head start. 

Your new classes are not re¬ 
stricted to use by C++ program¬ 
mers. With careful design, you can 
make C++ Presentation Manager 


classes available to C and other 
language programmers with no 
extra overhead. This is left as an 
exercise for the reader due to space 
considerations. Full compilable 
source code is available on 
CompuServe's OS2DF2 Forum, 
OS/2 Developer section. Down¬ 
load file CONTRL.ZIP. 

Eric Snell is an advisory programmer in 
OS/2 Multimedia development. His 
responsibilities include designing and 
implementing multimedia user interface 
and subsystem objects . Snell is currently 
the lead designer/developer for the OS/2 
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Zip 1510, Boca Baton , Fla. 33431, or via e- 
mail at esnell@vnet.ibm.com. 

Lori Ruffing is an associate programmer 
in OS/2 Multimedia development. Her re¬ 
sponsibilities include designing and devel¬ 
oping multimedia applications and user in¬ 
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WOO NW 51st Street t Inf. Zip 1510, Boca 
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Buyer's Guide 


The staff of OS/2 Developer put together this specieI section to guide you through the venous obiert 
oriented development tools available for OS/2. The products described,<n this guide ambased’oZ' 
surveys sent to vendors; they are provided as a service to you and are free to vendors These iistinos do 
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accuracy, we do not assume any responsibility for error or omission in this section. 


Object-Oriented Programming 
Buyer's Guide 


SOFTWARE GMBH Circle No, 101 

ViSuaiDesigner is an interactive, graphical 
software development tool that supports 
analysis, design, and programming. It cre¬ 
ates ready-to-use applications for Visual- 
Works and generates executable Smalltalk 
cede automatically for the object model, the 
user interface, and database access. It en¬ 
sures validation of defined requirements 
and improves communication between 
users and programmers. Price: $4,900, 

NEDT is a tool for designing complex 
graphical editors and is integrated Into the 
VisualWorks environment. The document 
to be edited can be arbitrary net structures 
represented by Smalltalk objects. NEDT 
provides predefined classes that imple¬ 
ment behavior for documents, document 
pages, and network components. There are 
two add-ons to NEDT, Black-Boxes is a 
generic graphical editor; potential applica¬ 
tions include petri net or chemical 
processes and any kind of electronic circuit 
design. Tree is a tool for designing graphi¬ 
cal editors. It facilitates the development of 
editors for tree structures by providing a 
generic tree editor that can be plugged to 
applications by simply specifying a few 
interface messages. Price: $1,800, 

VICK is a tool for interactively building 
graphical interfaces for VisualWorks. It 
provides a wide variety of predefined 
graphical user interface elements for con¬ 
trolling items like bar graphs, function ed¬ 
itors, sliders, and turning knobs. Browsers 
can be used to supervise the state of ob¬ 


jects permanently, and each object can 
have a multitude of task-dependent user 
interfaces concurrently. Price: $980. 

ARS NOVA Software GmbH, 
Stettener StraBe 32/3, 73732 Esslingen, 
Germany, +49-711-370-4001, fax +49-711- 
370-4003, 

A THENA DESIGN INC, Circle No . 102 

Mesa 2 is designed for users and develop¬ 
ers who want to combine the power and 
reliability of OS/2 with the flexibility and 
ease of object technology. You can leverage 
Mesa's power and flexibility by integrating 
Mesa objects into your own applications, 
using the Mesa Object Library Interface 
(MOLI). MOLI gives developers access to 
the same spreadsheet objects and features 
that Mesa 2 itself uses. Mesa 2 has the 
functionality and ease of use you expect 
from an advanced 32-bit spreadsheet prod¬ 
uct, Price: special introductory offer, $99, 

Athena Design Inc., 17 Saint Mary's 
Court, Boston, Mass, 02146-4007, (800) 315- 
6372 or (617) 734-6372, fax (617) 734-1130. 

BLUE SKY SOFTWARE CORP Circle No, 103 
WinMaker Pro 6,0, the new version of 
WindowsMAKER Professional, Proto¬ 
typer & C/C++ Code Generator for 
Windows, Win32, and Windows NT dou¬ 
bles C/C + + compiler productivity. 
WinMaker Pro 6,0 is as visual and easy to 
use as Visual Basic but provides the devel¬ 
oper with industrial strength C and C++ 
code instead of Basic, Price: $995. 
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Blue Sky Software Corp., 7486 La 
Jolla BlvtL, Ste. 3, La Jolla, Calif. 92037, 
(800) 677-4946 or (619) 459-6365, fax (619) 
459-6366, 

BORLAND INTERNA TIONAL Circle No 104 
Borland C++ 1.5 for OS/2 includes support 
for the latest C++ standards, including ex¬ 
ception handling and ANSI string classes, 
BPMCC control classes that bring the 
functionality of Borland-style custom con¬ 
trols to OS/2, and ObjectBrowser technol¬ 
ogy, which speeds up development cycles 
with graphical representations of the rela¬ 
tionships between objects in an applica¬ 
tion. Price: $495* 

Borland, 100 Borland Way, Scotts 
Valley, Calif*, 95066-3249, (408) 431-1000, 
fax (408) 431-4175. 

CADRE TECHNOLOGIES INC . Circle No. W5 
ObjectTeam for Shteer-Mellor 6,0 automates 
the Shlaer-Mellor methodology for object- 
oriented development and the production 
of documentation. Its analysis tool per¬ 
forms automated checking and lets users 
construct a graphic representation of a 
system. Its design tool lets designers cre¬ 
ate and modify design elements graphi¬ 
cally. Price: $4,000+. 

Cadre Technologies Inc., 222 
Richmond St., Providence, R.I. 02903, 
(800) 743-2273 or (401) 351-5950, fax (401) 
455-6800. 

CLASSIC SOFTWARE Circle No . 106 

Btrv++ 2.51 is a C++ library of 15 major 
classes providing a CXC++ database inter¬ 
face to Btrieve. It implements all Btrieve 
operations as member functions and many 
value-added funcions for SQL queries, file 
and index creation, iteration, extended op¬ 
erations, and global Btrieve management 
Complete record and field-based access. It 
includes an object-oriented C interface, 
C/C++ interface to Btrieve DDF Data 
Dictionaries, and 32-bit support. It is a 
multicompiler platform product support¬ 
ing Windows, Win32s, Win32, DOS, and 


OS/2 (16 and 32 bit). Source included. 
Royalty free. Price: $249. 

Birvgen 2.0c is a database schema de¬ 
signer and C++ code generator for Btrieve. 
It supports all Btrieve data types and has 
an integrated Btrieve DDF file editor. 
Generated code supports Windows, DOS, 
and OS/2, A special bundle is available 
with Btrv++ and VBtrv\C++ products. 
Price: $229. 

Classic Software Inc., 3542 Pheasant 
Run Circle, Ste. 8, Ann Arbor, Mich. 48108, 
(800) 677-2952 or (313) 677-0732, fax (313) 
971-3287. 

COMPILER RESOURCES INC , Circle No. 107 
Yacc++ and the Language Objects Library 20 

is an object-oriented rewrite of lex and 
yacc which automatically generates C++ 
classes of lexer, parser, and abstract syntax 
tree objects from grammars. The library 
provides classes for various models of 
AST, error, input, lexer, parser, and sym¬ 
bol table semantics. Price: $995. 

Compiler Resources Inc*, 85 Main St. 
Ste. 310, Hopkinton, Mass. 01748, (508) 
435-5016, fax (508) 435-4847. 

DIGITALK Circle No. 108 

Smalltalk/V for OS/2 is a 32-bit, object-ori¬ 
ented development environment for 
OS/2. It contains a set of tools for develop¬ 
ing graphical, portable CUA-eompliant 
applications and includes a reusable class 
library, a push button debugger, an incre¬ 
mental compiler, browsers, and inspec¬ 
tors. Price: $995. 

PARTS Workbench for OS/2 is a 

client/server integration tool that allows 
application development through easy as¬ 
sembly and reuse of application compo¬ 
nents. It comes with over 65 prebuilt com¬ 
ponents, both visual and nonvisual. Other 
components can be written in 
Smalltalk/V, C, COBOL, or other lan¬ 
guages. Price: $1,995, 

Digitalk PARTS 1.0 (Parts Assembly and 
Reuse Tool Set) is a component-based ap¬ 
plication development environment con- 
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sisting of PARTS Workbench, 
Smalltalk/V, and Tearn/V, a team 
programming and configuration 
tool Pricer $5,000. 

Digitalk, 5 Hutton Centre Dr., 
Santa Ana, Calif. 92707, (800) 922-8255 
or (714) 573-3000, fax (714) 513-3100. 

EASEL CORP. Circle No. 109 

Synchronicity 1.0 is a development 
tool set for business object manage¬ 
ment that lets corporate Information 
Services organizations move to ob¬ 
ject technology. It integrates the de¬ 
sign, assembly, and reuse of busi¬ 
ness objects to reduce the time 
required to develop, enhance, and 
extend strategic enterprise client/ 
server applications. It is integrated 
with ENFTN. 

ENFIN 4.0 is an object-oriented 
client/server application develop¬ 
ment environment based on 
Smalltalk, It provides developers 
with a spectrum of tools to develop 
modular reusable applications that 
can be deployed across a multiplat¬ 
form network. It has a layer of visual 
tools to improve programmer pro¬ 
ductivity and is integrated with 
Synchronicity, Price: $5,995 SQL 
Edition, $10,900 Corporate Edition, 

TeamBuilder 1.0 is a development 
tool that enables groups of develop¬ 
ers to simultaneously build object- 
oriented applications. Developers 
can group objects together as a pro¬ 
ject, with each having a separate re¬ 
vision level, date stamp, and label. It 
is integrated with Intersolv's PVCS 
product, providing functionality- 
archiving older classes and files, 
comparisons between revisions, and 
labeling. Price: $495. 

Easel Corp., 25 Corporate Dr., 
Burlington, Mass, 01803, (800) 625- 
3281 or (617) 221-2100, fax (617) 
221-2196. 

FOUR SEASONS 

SOFTWARE Circle No. 1W 

SuperNOVA 3.3 is an object-oriented, 
platform- and database-independent 
4GL that allows applications to run 
on networks consisting of different 
operating systems and proprietary 
databases. Its database independence 
allows applications to be developed 
without using database-specific code, 


and its platform independence allows 
graphical user interface programs to 
run in MOTIF, Open Look, or MS- 
Windows, It is portable through 
UNIX, MS-DOS, and VAX VMS 
Price: $1,740 to $190,000 per CPU de¬ 
pending on configuration. 

Four Seasons Software, 2025 
Lincoln Highway, Edison, N.J. 08817 
(908) 248-6667, fax (908) 248-6675. 

FREE UNIVERSITY OF 
RERUN Circle No. Ill 

Distributed Application Developer s 
Toolkit 1.0 consists of RPC class li¬ 
brary (C++), XDR library, and OS/2 
RPC stub generator. It enables inex¬ 
perienced programmers to imple¬ 
ment distributed applications. By 
applying the stub generator, nondis- 
tributed applications can be turned 
into distributed ones with almost no 
changes to the source code. The 
OS/2 Distributed Application 
Developer's Toolkit is delivered 
with documented APIs for C++ and 
numerous examples. Price: $49 plus 
shipping. 

Free University of Berlin, WRZ, 
Garystrasse 21, D-14195 Berlin, 
Germany, +49 308382775, fax +49 
308382843. 

IBM Circle No. 112 

Visual Age allows the developer to 
create industrial-strength client/ 
server applications quickly. Both 
stand-alone and team versions are 
backed by IBM service and support. 

It allows you to visually construct 
applications by selecting and con¬ 
necting reusable software compo¬ 
nents, iterate on design, reuse Legacy 
or 3GL, and access multiple data¬ 
bases simultaneously. According to 
the company, it includes an easy-to- 
use composition editor. 

IBM, 11000 Regency Parkway, 
Cary, N.C 27511, (800) 426-2279 or 
(919) 469-7763, fax (919) 469-7423. 

INFERENCE CORP: Circle No. 113 

ART *Enterprise 1.0 is a graphical 
client/server development tool that 
uses objects to integrate databases, 
documents, and business policies. 
Users access objects with free-form 
descriptions of the nature or location 
of the underlying information. 


Applications apply policies to volun¬ 
teer intelligent advice. Example ap¬ 
plications include sales force automa¬ 
tion, direct marketing, customer 
service, and scheduling/fogistics. 
Price: $7,995 including one week of 
training. 

Inference Corp., 500 N. 
Continental Blvd., El Segundo, Calif 
90245, (800) or (310) 322-0200, fax 
(310) 322-3242. 

INSOFTOY Circle No. 114 

Prosa/pm Object Oriented Analysis and 
Design Tool 4.0 supports Rumba ugh 
GMT method. Correctness of models 
is checked interactively. The user in¬ 
terface of Prosa/om is fast and easy 
to use, and it supports team devel¬ 
opment in networked environments. 
It integrates with Prosac++ code 
generation, with Prosaql for SQL 
code generation and with Prosaedm 
for automated, concurrent documen¬ 
tation. Price: $3,230. 

Prosa/sa Structured Analysis and 
Design Tool 4.0 supports Yourdon 
SA/SD/RT method as a system and 
software specification and design 
methodology. The models are de¬ 
signed with the same modeling edi¬ 
tor, providing an integration of mod¬ 
els and interactive checking of 
models. It integrates with Prosac++ 
code generator for C code, Prosaql 
for SQL code, and Prosacdm for au¬ 
tomated, concurrent documentation. 
Price: $3,230. 

Prosac++ C++ Code Generator 4.0 

transforms OOA/OOD models de¬ 
signed with Prosa/om into C++ 
source code and SA/SD/RT models 
designed with Prosa/sa into ANSI 
standard C source code. The gener¬ 
ated C/C++ code is ready to com¬ 
pile, link, and execute. Its code is 
portable and compact. Prosac++ 
supports auomatic generation of ap¬ 
plications ranging from client/ 
server and database systems to inter¬ 
active, windows, and real-time sys¬ 
tems. Price: $4,120. 

Prosac SQL Code Generator trans¬ 
forms object models designed in 
Prosa/om OOA/OOD and entity re¬ 
lationship models designed in 
Prosa/sa SA/SD/RT CASE environ¬ 
ments into SQL code. Prosaql checks 
the models for inconsistencies in 
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Object: Oriented Programming 
Using SOM and DSOM 

TheTrsfcompfehensive guide to SOM technology and its accompanying 
frameworks. Especially valuable now that SOM for Windows is avai'abte 

Answers questions, provides codes and c°^^ ° R 

specifications. Includes disk. $39.95 0-442-01948-3 IBM #SR28 5570 
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Client/Server Survival Guide 
with OS/B® 

by Rob ert Orfali and Dan Harkey 

Provides a sweeping tour of client/server and distributed 
objects. An easy-to-follw guide that comprehensively reviews 
the technology, standards and over fifty commercial OS/2 
client/server products. Offers 969 pages of essential information 
plus 400 illustrations. $39.95 0-442-01798-7 IBM #SR28-5494 

Client/Server Programming 
with 05/2 P.1, 3/E 

by Robert Orfali and Dan Harkey 
$39.95 0-442-01833-9 IBM #<5325-0650-02 


Objects for OS/B B.X 

by Bruce Tate. Scott Oanfurth. and Paui Koenen 
Integrates the System Object Model with OS/2 2,1 client 
server functions. Explains how OOP and SOM function, why 
they are important, and how they relate to OS/2 2.1. 

$36.95 0-442-01738-3 IBM #SR28-5568 






Develuping C/C++ Software in 
the OS/a® Environment 

by V. Mitra Gnpaul 
This important OS/2 programmer's reference combines OS/2 
development tools that are scattered through many different IBM 
manuals into one easy-to-use source, Covers all levels of C and 
C++ application development in the OS/2 environment using the 
IBM C Set++Compiler. $39.95 0-442-01240-3 IBM #SR28-5569 


Ask for these and other VNR titles 
at your local bookstore. 
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database definitions, primary and 
foreign keys, attributes, relationship 
cardinalities, normalization, and 
syntax rules of the target DBMS- It is 
compatible with ISO/IEC SQL stan¬ 
dard, DB2, Informix, Ingres, and 
Oracle database management sys¬ 
tems* Price: $1,175. 

Insoft Oy, Prosa Software, 
Kirkkokatu 5 B, FIN-90100, Oulu, 
Finland, +358-81-376128, fax +358- 
81-371754. 

mmuGENT 

ENVIRONMENTS Circle No. US 
Applications Manager 4.3 is a compre¬ 
hensive, high-level OS/2 develop¬ 
ment environment for creation of 
large-scale client/server applica¬ 
tions. It helps teams develop graphi¬ 
cal user interfaces, logic coding and 
testing, data integration, communi¬ 
cations, quality control, and mainte¬ 
nance. It is designed for scalable, 
multimodule applications and sim¬ 
plifies mission-critical programming 
requirements for SQL, transaction 
management, and legacy system ren¬ 
ovations* Price: contact vendor. 

Intelligent Environments, 2 
Highvvood Dr., Tewksbury, Mass* 
0187, (800) 669-2797 or (508) 640- 
1080, fax (508) 640-1090. 

INTERACTIVE SOFTWARE 
ENGINEERING INC Circle No , 116 

ISE Eiffel for OS/2 3.3 is an object-ori¬ 
ented software development envi¬ 
ronment for building large, complex, 
in-house, and commercial applica¬ 
tions* It consists of an integrated de¬ 
velopment workbench, an interac¬ 
tive application and graphical user 
interface builder, analysis and de¬ 
sign CASE tools, database interfaces, 
and a variety of basic, graphical, and 
application-specific libraries. Price: 
$695-$995. 

Interactive Software Engi¬ 
neering Inc*, 270 Storke Rd., Suite 7, 
Goleta, Calif. 93117, (805) 685-1006, 
fax (805) 685-6869. 

JBA INTERNATIONAL Circle No. 117 

Guidelines 2 . 1A is an object-oriented 
OS/2-hosted graphical user interface 
development environment that auto¬ 
mates most of the creation of a 
graphical user interface applications. 


eliminating some traditional steps. 
Developers are able to create appli¬ 
cations ranging from fully event dri¬ 
ven procedural to event driven ob¬ 
ject oriented. It creates native OS/2 
and Windows 3*1 applications* 
Supported servers include the DB2 
family, ODBC, SQL-based RDBMs, 
and over 40 databases through the 
Q+E libraries. Price: contact vendor. 

JBA International, 3701 
Algonquin Rd., Crossroads Ctr. Ste. 
1000, Rolling Meadows, III. 60008, 
(800) 522-4685 or (708) 590-0299 or 
in Canada (905) 940-2442, fax (708) 
590-0394. 

KASE SYSTEMS Circle No. 118 

KAS£:C++ is a visual design and 
code-generation tool for the OS/2 
platform. Developers use the design¬ 
ers to create OS/2 objects and associ¬ 
ate them with business logic and 
data. KASE:C++ will then generate 
the C++ source code* It fully sup¬ 
ports IBM's User Interface Class 
Library. Price: $1,495. 

KASE Systems, 1 Meca Way, Ste. 
150, Noreross, Ga. 30093, (404) 564- 
5696, fax (404) 564-5679. 

UANT SOFTWARE 

CORF. Circle No. 119 

C++/Views 3.0, 1 is an object-oriented 
application framework for develop¬ 
ing multiplatform, native graphical 
user interface programs using C++. 
It includes a library of over 100 C++ 
classes for developing your graphi¬ 
cal user interface application* It in¬ 
cludes C++/Views Constructor, a vi¬ 
sual development tool that unites an 
interface builder with a class 
browser. Price: $999* 

Liant Software Curp., 959 
Concord St*, Framingham, Mass. 
01701, (800) 237-1873 or (508) 872- 
8700, fax (508) 820-0035. 

MICADO SOFTWARECONSUL T 
GMBH Circle No. 120 

micWOP Developer 2.0 is a develop¬ 
ment environment for Smalltalk/V 
(OS/2 2.x 32 bit or Win32) that has 
and uses various commercially 
available Smalltalk/V add-on prod¬ 
ucts* Included are a WindowBuilder, 
project organizing utilities 
(ProjektBrowser or Team/V or 


Envy), and add-ons developed by 
micado, such as a translator, a docu¬ 
mentation manager, and an environ¬ 
ment manager. Price: $2,710. 

micWOP Corporate ts a develop¬ 
ment environment for Smalltalk/V 
(OS/2 2.x 32 bit or Win32) that ex¬ 
tends the micWOP Developer with 
database classes* It uses the Q+E as 
well as the ODBC driver, which pro¬ 
vides access to most of the commer¬ 
cially available databases: MS SQL 
Server, Sybase SQL Server, Oracle 
version 6+7, IBM DB 2/2, IBM DB2- 
IBM SQL/400-IBMSQL/DS via 
Gtwy, Gupta, dBase, II+IV, Novell 
SQL+BTrieve, Excel, and so on* 
Price: $5,410. 

micWOP (micado Workplace for 
Smalltalk/V) Corporate ODBMS 2.0 is a 

development environment for 
Smalltalk/V (OS/2 2.x 32 bit and/or 
Win32) that extends the micWOP 
Corporate with an object-oriented 
database component. Price: $8,120* 
micDESIGNER 1.0 is a graphical 
development environment for 
Smalltalk/V (OS/2 2.x 32 bit and/or 
Win 32) that enables one to put to¬ 
gether a class and method frame¬ 
work. The result is not mnemonic 
class and method description but a 
class hierarchy in pure Smalltalk 
code. Price: contact vendor. 

micado SoftwareConsult GmbH, 
Reutherstr. 1 a-c, 53773 HENNEF, 
Germany, +49-(0)2242-871-450, fax 
+49-(0)2242/871-455. 

MICRO DATA BASE 

SYSTEMS INC Circle No. 121 

Object/1 3.0 is a graphical develop¬ 
ment environment for DOS 
Windows and OS/2 Presentation 
Manager. It offers an object-oriented 
programming language, forms 
painter, and open architecture* 
Access to DMBSs such as MDBS IV, 
SQL Server, Oracle RDBMS, and 
IBM Database Manager is available. 
It has over 250 predefined classes, 
6,000 predefined methods with 
source code, full DDE support, and 
C++-like syntax. Price: $4,000* 

Micro Data Base Systems Inc*, 
1305 Cumberland Ave., P.O. Box 
2438, West Lafayette, Ind* 47906, 
(800) 445-6327 or (317) 463-7200, fax 
(317) 463-1234. 
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NETWORK TECHNOLOGY 

CORP, Circle No , 72? 

OS/2 Desktop Edition pro 

vides a visual programming environ¬ 
ment for the development of object- 
oriented multimedia applications. It 
fully supports digital, audio, midi, 
animation, software and hardware 
video, ActionMedia II, and MPEG in 
the OS/2 environment. It is a multi¬ 
threaded multimedia tool and pro* 
vides an icon-based authoring inter¬ 
face for nonprogrammers. Price* 
$895, 


MEDiAscript OS/2 Professional 
Edition provides a visual program¬ 
ming environment for the develop¬ 
ment of object-oriented multimedia 
applications. The Professional 
Edition provides an icon-based au¬ 
thoring interface for nonprogram¬ 
mers as well as the rich 
MEDiAscript scripting language for 
more demanding requirements. 
Price: $3,995. 

Network Technology Corp,, 
P.O. Box 240, Dobbs Ferry, N.Y. 
10522-0240, (914) 478-4500, fax (914) 
478-4507, 


NEURON DA TA INC . Circle No, 123 

NEXPERT OBJECT 3M is an object- and 
rule-oriented application develop¬ 
ment tool. It incorporates business 
rules and object components that en¬ 
able you to add simple or complex 
business rules to make applications 
"smarter." Using an intuitive visual 
editor, you enter If-Then-Else rules 
in any sequence and as separate enti¬ 
ties without predefining program 
flow r control. Thus, you can update 
rules to adapt to changing business 
conditions. Price: $8,250. 

SMART ELEMENTS 20 provides a 
development environment for gener¬ 
ating portable, object-oriented 
client/server applications that incor¬ 
porate business rules and objects. A 
graphical user interface builder com¬ 
ponent includes a comprehensive set 
of interface widgets—tables, tree 
browsers, business graphics, color 
icons and images, and multifont text. 
With optional transparent data ac¬ 
cess component, applications can 
connect to various data sources. 
Price: $13,850, 


Neuron Data Inc., 156 Uni¬ 
versity Ave., Palo Alto, Calif. 94301, 
(800) 876-4900 or (415) 321-4488, fax 
(415) 321-3728, 

OBJECT/FX Circle No , 124 

Visual Companion 1,0 is an object-ori¬ 
ented geographic visualization sys¬ 
tem that stores and presents infor¬ 
mation in the form of maps, tables, 
and images. The system enhances 
other information products with ge- 
ographic visualization and analysis 
capabilities, regardless of source lan¬ 
guage. Price; $1,000. 

Spatial Works 1.0 is designed for 
use by object-oriented software de¬ 
velopers. This product provides 
component and framework classes 
for reuse by those who assemble 
new object-oriented products that 
require geographic data manage¬ 
ment, visualization, and analysis. 
Price: $7,500 Development, $1,000 
Run-time. 

Object/FX, 2515 Wabash Ave., 
St. Paul, Minn. 55114, (612) 644-6064, 
fax (612) 644-6064 ext. 17. 

OBJECT INTERN A TIONAL 
INC Circle No. 125 

Together/C++ allows up-to-date object 
modeling and C++ programming. 
Changes in the user's object model 
appear in code, and added code gets 
reflected in the object model It in¬ 
cludes view management, filtering, 
automatic layout, C++ parser, 
scripted documentation generation, 
and version control. Price: $4,400. 
Special introductory pricing is avail¬ 
able for a limited time. 

Object International Inc., 8140 
North MoPac, 4-200, Austin, Tex. 
78759, (800) 662-2667 or (512) 795- 
0202, fax (512) 795-0332. 

OBJECTS INC Circle No. 126 

Layout 3.0 is an object-oriented appli¬ 
cation development system that en¬ 
ables users to build applications 
without using a programming lan¬ 
guage. Instead, users work with ac¬ 
tual on-screen objects, arranging 
them in a simple diagram to repre¬ 
sent their program. Price: $299.95. 

Objects Jnc. 99 Rosewood Dr., 
Danvers, Mass. 01923, (800) 424- 


6644 or (508)777-2800, fax (508) 
777-0180. 

OBJECTSHARE SYSTEMS 

Circle No . 12? 
WidgetKit/CUA 91 provides the suite 
of CUA'91 controls for Digitalk 
Small talk/V on Windows and 
Win32 as well as OS/2 when used in 
conjunction with WindowBuilder 
Pro/V. The WidgetKit/CUA'91 con¬ 
trols integrate transparently into the 
Smalltalk/V and WindowBuilder 
Pro/V environment. Available con¬ 
trols include Note Bo ok. Container, 
Slider, ValueSet, and SpinButton. 
Source code included; no run-time 
fees. Price: $295. 

Objectshare Systems Inc., 5 
Town & Country Village, Ste. 735, 
San Jose, Calif. 95054, (408) 970-7280, 
fax (408) 970-7282. 

OBJECTS++ SOFTWARE 

CORP, Circle No. 128 

SQL Objects** Database Library 20 is a 

complete multiplatform object-ori¬ 
ented class library that provides 
complete database access to many of 
the major databases with a single 
API/Method. SQL Objects++ allows 
you to use the native database ven¬ 
dor API, a common API/Method, or 
an abstract access method where no 
SQL knowledge is needed, SQL 
Objects++ supports OS/2 (32-bit), 
NT, Windows, and UNIX with the 
same API/Method. SQL Qbjects++ 
can be called from development 
tools that can call a C/C++ DLL. 
SQL Objects++ supports Oracle, 
Sybase, SQL Server, DB2/2, SQL 
Base, Watcom SQL, Btrieve, Netware 
SQL, Informix, and others. Price: 
$695. 

Objects++ Software Corp., 47 
Stonewall St., CartersviUe, Ga. 30120, 
(800) 876-6585 or (404) 382-6585, fax 
(404)382-6374. 

OBJECT TECHNOLOG Y INTERNA TIONA L 
INC Circle No. 129 

ENVY/Beveloper is an integrated 
multiuser environment for serious 
Smalltalk development. It features a 
highly productive team program¬ 
ming environment that enables the 
development, release, and mainte- 
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nance of Smalltalk applications. Its 
version control and configuration 
management features provide con¬ 
trol for software engineering while 
enhancing the individual Smalltalk 
developer. 

Object Technology International 
Inc v 2670 Queensview Dr., Ottawa, 
Ont, Canada k2b 8K1, (613) 820- 
1200, fax (613) 820-1202. 

ORANGE HILL 

SOFTWARE Circle No. 130 

IControl/DE 2,15 allows developers to 
choose from over 500 professionally 
drawn icons to use in programs or 
WPS objects. It is royalty free and 
provides the features of OHS' 
IControl Plus-automatic icon appli¬ 
cation, icon starter templates, devel¬ 
oper's utilities, additional icons, and 
Workframe/2 integration. 

Orange Hill Software, P.O. Box 
907, Atwood, Calif. 92601, (714) 524- 
5851, fax (714) 996-7430. 


Protosoft, 17629 El Camino Real, 
Sutie 202, Houston, Tex. 77058, (713) 
480-3233, fax (713) 480-6606. 

POET SOFTWARE Circle No, 133 

Poet 2,1 is a C++ Object DBMS avail¬ 
able in single user and client/server 
versions. Developers save time since 
there is no need for writing code to 
break up C++ objects into tables and 
to preserve their object's encapsula¬ 
tion, inheritance, identity, pointers, 
and polymorphism. Poet is portable 
and heterogeneous on OS/2, Win¬ 
dows, WFW, NT, Macintosh, Novell, 
and UNIX. Price: $499 Personal 
Edition, $3,495 Professional Edition. 

Poet Software, 4633 Old 
Ironsides Dr. Ste. 110, Santa Clara, 
Calif. 95054, (800) 950-8845 or (408) 
970-4640, fax (408) 970-4630. 

SOFTBRIDGE INC. Circle No. 134 

Automated Test Facility 3.1 tests 
client/server and stand-alone object- 


oriented OS/2 and Windows appli¬ 
cations. From a central point, it runs 
simultaneous, unattended tests on 
multiple PCs. It tests all 
client/server layers: graphical user 
interfaces, distributed applications, 
and legacy systems. Users may take 
a capture/playback or full scripting 
approach to testing. Price: $18,000 
and up, depending on configuration. 

Softbridge Inc., 125 Cambtdge 
Park Dr., Cambridge Mass. 02140, 
(800) 955-9190 or (617) 576-2257, fax 
(617) 864-7747. 



SYNTEGRATION Circle No. 135 

The Secure Workplace for OS/2 1.55 is a 

collection of OS/2 workplace objects 
and programs utilities designed to 
provide a secure desktop environ¬ 
ment. These objects protect the OS/2 
desktop from unwanted changes or 
intrusions. Objects can be set to a 
locked position. The product in¬ 
cludes setup utilities to help you 


PARCPLACE SYSTEMS 
INC. Circle No. 131 

Visual Works 2,0 is a client/server tool 
for building portable applications 
using object-oriented technology. A 
Database Application Creator is in¬ 
cluded for developing applications 
that are portable across multiple 
platforms, scalable across the enter¬ 
prise, and have their functionality 
distributed between both clients and 
servers. Price: $429.95 for Windows, 
NT, Mac, OS/2; $49.95 for UNIX. 

ParcPlace Systems Inc., 999 East 
Arques Ave., Sunnyvale, Calif. 
94086-4593, (408) 481-9090, fax (408) 
481-9095. 

PROTOSOFT Circle No. 132 

Paradigm Plus 2.0 is an object-oriented 
CASE tool that supports the indus¬ 
try's methodologies: Rumbaugh 
OMT, Shlaer/Mellor, Fusion, Booch, 
and Coad/Yourdon. Platform sup¬ 
port includes PC/Windows, Sun OS, 
Solaris, HP-UX, and more. Other fea¬ 
tures include code generation in C, 
C++, Ada, Smalltalk, CORBA IDL, 
and SQL. Price: begins at $3,995 for a 
PC fixed copy, $7,700 for a UNIX 
copy; volume discount pricing 
schedule does apply. 


4c« control of your OS/2 ochoduting naads with 
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Version 3.0 

Are ^>u looking for a way to Hera are some of the featuree of 

ATS for OS/8: 

* Manage Production Job 


manage your production job 
streams? Do you have programs 
that need to run after the 
completion of one or more other 
programs? Do you want to run 
programs on a regular basis? Do 
you want to process files that 
have just been received from 
Brother system or modified 
locally? Do you need to take action 
if a file is missing? Do you need to 
schedule around holidays and 
periods of heavy CPU load? 

With ATS you can run your 
programs when YOU want them 
to run with out you having to be 
there. .,«»'• 

A* - ” 

I v ^ gon __ 

Software and Consulting 

° *** 2227 U.S. Highway *1 ‘Suite 146 

Morth Brunswick, NJ 08902 __ 


Streams 

* Programs can be scheduled to 
run anytime. 

* Programs can be dependent 
upon Files, Other Programs, 
Holiday Schedules, and 
External Signals 

* Integrated Operators Console 

* Logging-To File and Console 
New Features: 

* Job Queues-for managing 
your resources while managing 
your tasks 

* Periodic Scheduling 

* COMPLETE API and Command 
Line Interface 
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configure a secure workplace. Price: 
$59.95 for single-station End User 
Edition, $549 for 10-station 
Enterprise Edition, 

Syntegration, 13241 Norton 
Ave., Chino, Calif, 91710, (909) 464- 
945, fax (909) 627*3541, 


TECHNICALLY 

SPEACKIN6 Circle No. 136 

Show N Tel lets you visualize and de¬ 
sign applications of any size and 
scope. Slick graphical user interface 
provides unprecedented ease of use 
while providing extensive database 
support, host integration, high port 
density, error handling, on-line help, 
and a host of other features. Price: 
$2,995. 

Technically Speaking, 171 Main 
St., Ashland, Mass. 01721, (508) 881- 
1900, fax (508) 881-7320. 


TOWER TECHNOLOGY 
CORP. Circle No. 137 

The TowerEiffel System 1.3 is a com¬ 
plete object-oriented programming 
system that includes a high-perfor¬ 
mance Eiffel 3 compiler, develop¬ 
ment environment, programming 
tools, and a base set of reusable soft¬ 
ware components. A unique capabil¬ 
ity of the TowerEiffel System is sup¬ 
port for multilanguage development 
and interoperability between Eiffel, 
C, and C++, Price: $1,295 commer¬ 
cial license, $389 individual license. 


$129 university faculty license, $100 
60-day evaluation license. 

The Eiffel Qooch Components 12 is 
the Eiffel verson of Booth 
Components. Reengineered to take 
advantage of Eiffel's unique capabil¬ 
ities, the Eiffel Booth Components 
are a carefully designed set of Eiffel 
clusters that provide a complete col¬ 
lection of efficient and adapthle do¬ 
main-independent data structures 
and algorithms. Price: $995 commer¬ 
cial license, $299 individual license, 
$99 university faculty license. 

Tower Technology Corp,, 1501 
Koenig Ln., Austin, Tex, 78756, (800) 
285-5124 or (512) 452-9455, fax (512) 
452-1721, 

TRINZIC CORP. Circle No l 138 

Aion Development System (AionDS) is 
a rule-based, object-oriented devel¬ 
opment tool for client/server and 
mainframe environments. AionDS is 
intended for problems that incorpo¬ 
rate business policies and judge¬ 
ment. AionDS is typically used to 
develop applications that are too dif¬ 
ficult to code and maintain produc¬ 
tively in 3GL languages and 4GLs. 
Price: $10,000. 

Trinzic Corp,, 101 University 
Ave., Palo Alto, Calif. 94301, (415) 
328-9595, fax (415) 321-7728. 

VISIX SOFTWARE Circle No. 139 

Galaxy 2.0 is a cross-platform devel¬ 


opment environment designed for 
creating large-scale mission-critical 
applications that are graphical and 
distributed. Galaxy assembles a set 
of visual tools, object-oriented li¬ 
braries, and distributed services into 
one environment Applications can 
be built and compiled to run enter¬ 
prise-wide on a broad range of desk¬ 
top and server platforms, networks, 
and window systems without chang¬ 
ing code, it can run with UNIX, 
Windows, Windows NT, Macintosh, 
OS/2, and Open VMS, Price: $9,600 
for C version, $12,100 for C++. 

Visix Software, 11440 Commerce 
Park Dr., Reston, Va. 22091, (800) 
832-8668 or (703) 758-8230, fax (703) 
758-0233. 

ZINC SOFTWARE 

INC. Circle No . 140 

Zinc Application Frame work 3.6 is an 

object-oriented, multiplatform, inter¬ 
nationalized C++ class library. It 
supports IBM OS/2, Microsoft 
Windows, Win32s and Windows 
NTm OSF/Motif, Curse, DOS 
Graphics and DOS Text, Apple 
Macintosh, and NEXTSTEP within 
one set of source code. Zinc de¬ 
signer, a multiplatform visual devel¬ 
opment tool, is included. Price: $798. 

Zinc Software Inc., 405 South 
100 East, 2nd Floor, Pleasant Grove, 
Utah 84602, (800) 638-8665 or (801) 
785-8900, fax (801) 785-8996. 
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New Tools for OS/2 


Review. This image archival, storage, 
and retrieval system has a hierarchical 
file system, direct scanner support, file 
format support, and file conversion for 
importing images. It currently supports 
the HP IIP, IIC, and UCX scanners and will be able to 
support other scanners later this year. 

In a separate event, the company has recently 
announced a maintenance and feature release of 
APPLAUSE 1.1. It includes support for Photo CD, 
IBM IOCA, Targa, and others. It will be sent to all 
registered users. 

Solution Technology Inc. Circle No. 141 

Phone: (407) 241-3210, Fax: (407) 997-6518 

SYSQL For Windows , This middleware product takes 
advantage of the 32-bit architecture of OS/2 and pro¬ 
vides access to S/390 data and services from OS/2 
applications. Users may develop client/server appli¬ 
cations on OS/2 platforms using any development 
tool (like C, COBOL, REXX, and CA's Realizer) and 
get direct access to data and services (such as VSAM, 
DB2 or ADABAS files, JES Spool files, and PDS 
libraries) on Host MVS systems using SLYSQL facili¬ 
ties. SYSQL also supports Remote Procedure Calls 
and comes with more than 50 predefined mainframe 
functions, to which users can add their own. 

Text Systems International Circle No, 142 

Phone: (203) 637^549, Fax: (203) 698-2409 

PM Assistant 2ft This suite provides hot-key access to 
applications, automatic window placement, keyboard 
macros, task scheduling, a screen saver, and pass¬ 
word protection. The six utilities are integrated into a 
single seamless program and can be used together to 
accomplish complex tasks, PM Assistant 2.0 runs on 
OS/2 2,0 or greater and can automate and customize 
OS/2 and applications according to each user's pref¬ 
erences, PM Assistant does not contain a program¬ 
ming language; all utilities are configured with dialog 
boxes and by pointing to the application to act on. 


Utilis Inc. Circle No. 143 

Phone: (206) 467-4025 

Quantum Leap 2.1. This is an advanced version of 
Quantum Leap for OS/2 business problem solving 
software. It capitalizes on the new symmetric multi¬ 
processing (SMP) version of OS/2, providing the abil¬ 
ity to "scale up" to SMP machines and take advan¬ 
tage of a heterogeneous network of personal comput¬ 
ers and RISC System/6000 workstations. Quantum 
Leap 2.1 provides Application Programmer Interfaces 
(APIs) that allow consultants, corporate developers, 
and value-added resellers to embed Quantum Leap 
models and problem-solving technology in solutions 
created for their users. Users can create and maintain 
complex models, representing dynamics of a real-life 
business environment by using the graphical user 
interface. Training and consulting services are offered 
through Quantum Craft to support many industries. 

Quantum Development Corp, Circle No, 144 

Phone: (302) 798-0899, Fax: (302) 798-6813 

AM COBOL. This software for OS/2 allows developers 
to reuse existing COBOL code in client/server appli¬ 
cations and write portions of client/server applica¬ 
tions in COBOL. The AM COBOL Interface links 
client/server applications with background Micro 
Focus COBOL programs in a sound peer-to-peer 
architecture. AM COBOL Interface helps corporate 
programmers with COBOL backgrounds use their 
skills for client/server development. According to the 
company, AM customers can better leverage their 
3GL programming skills. 

The company has also announced the release of 
AM AA1 Interface, AM Interface for CICS OS/2, and 
AM Interface for Existing DLLs, 

Intelligent Environments Circle No. 145 

Phone: (508) 640-1080, Fax: (508) 640-1090 

Notrix. Percussion has released a programming tool 
for easily manipulating large, complex Notes data- 
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bases and building Notes workflow 
applications. Notrix fills the '"program¬ 
ming gap" between the Lotus Notes 
macro language and the Lotus Notes 
application programming interface. 

Notrix Composer Version 1 for 
EDA/SQL. This tool lets Notes users 
view and manipulate data from more 
than 50 different databases supported by 
Information Builders' Enterprise Data 
Architecture (EDA)/SQL client/server 
software. 

Both products include the Notrix 
Event Manager, which acts as an active 
information agent, enabling customers to 
automatically trigger events within Notes 
or in outside applications in response to 
designated events within Lotus Notes 
databases, documents, and document 
fields. Both products run on OS/2-based 
servers and work with any Notes-sup- 
ported client, including OS/2, Windows, 
and Macintosh without additional Inter- 
face programming or client software* 

Percussion 

Software Inc* Circle No. 146 

Phone: (617) 267-6700, Fax: (617) 266-2810 

Unite imaging Object Set This object set, 
based on IBM's SOM technology, is 
designed for mission-critical OS/2 appli¬ 
cations and includes Image Viewer, Scan¬ 
ner Manager, and Storage Manager. 
IBM's SOM object-oriented programming 
interface is language independent and 
supported by Open Doc, Taligent, and 
OS/2 for the Power PC. SOM methodol¬ 
ogy allows the Cirrus objects to be 
accessed not only from C++ but from pro¬ 
cedural languages as well. The object set 
is available as fully functional APIs or can 
be integrated as enabled parts with IBM's 
VisualAge development environment or 
with Watcom's VX-REXX development 
environment* Users can implement a 
common set of reusable components in 
applications to reduce development time* 
The object set is designed for OS/2 net¬ 
works. 

Cirrus Technology Inc; Circle No. 147 
Phone: (301) 698-1900 

CasePoint The company has announced 
an OS/2 tool selected by IBM for inclu¬ 
sion as a primary tool in enhancing sup¬ 
port for OS/2 in a new companion ser¬ 
vice offering for problem resolution called 


the Technical Connection CD-ROM, 
available directly from IBM* CasePoint 
helps businesses reengineer customer 
support with problem guidance and reso¬ 
lution, CasePoint provides guided access 
to an evolving case of experience, such as 
prior customer problems with known 
solutions. The user interface accepts user 
input in freeform natural language, pro¬ 
poses clarifying questions to ask the 
caller, interprets the answers, and identi¬ 
fies those cases that explain and resolve 
the caller's problem* 

Inference Corp* Circle No* 148 

Phone: (310) 322-0200, Fax: (310) 322-3242 

Just Logic/SQL Database Manager , The rela¬ 
tional database server is made to be used 
from C and C++ programs and is meant 
for professionals w r ho write simple to 
complex C applications and need a flexi¬ 
ble performing database. There are three 
programming interfaces to choose from: 
a complete set of C++ class definitions, a 
complete C Application Program Inter¬ 
face, and a standard C precompiler. The 
database delivers a true relational data¬ 
base on OS/2 and compatibility with 
most popular compilers. 

Just Logic 

Technologies Inc. Circle No. 149 

Phone: (800) 267-6887 or (514) 761-6887, 
Fax: (514) 642-6480 

Thompson Toolkit 3.0. The toolkit provides 
f ull compatibility, which allows you to 
customize UNIX or DOS to your prefer¬ 
ence, It has a new network support serv¬ 
er, a command history window, and a 
"vi compatible editing mode. Other 


features include an "exec" command for 
shell I/O redirection, a "select"' command 
to automatically print menus, a "dosenv" 
command to modify the DOS environ¬ 
ment, a "fullpath" command to construct 
absolute path names, and a [[ ]] command 
to test variables, files, and options. The 
product has a random number generator, 
lapsed time counter, and new options in 
SHEXPAND variable to provide greater 
control of DOS command line expansion* 

Thompson 

Automation Inc. Circle No. 150 

Phone: (800) 944-0139 or (503) 224-1639, 
Fax: (503) 224-3230 

CC-Rider. The standard edition of the 
package includes both the CCSYM Sym¬ 
bol Compiler and the CCRider pop-up 
utility, providing basic analysis for small 
or large projects* It includes function pro¬ 
totyping, log file generation, QuickHelp 
support, and hypertext retrieval of all 
symbol definitions from the editor. The 
professional edition provides more exten¬ 
sive source code analysis for big projects 
and can cross reference all active symbol 
usages. The editor can navigate through 
source files with knowledge of a pro¬ 
gram's functions and variables* 

Western Wares Circle No* 151 

Phone: (303) 327-4898 

SMART 2.0. An enhanced version of the 
migration toolset that shipped in May, this 
version adds functionality that will double 
the speed of a conversion effort. SMART 
2*0 supports 16-bit and 32-bit Windows 
application migration to 32-bit OS/2 as 
well as 16-bit OS/2 to 32-bit OS/2. It 


OS/2 CALENDAR 


Oct* 4-6 


Oct 30-Nov, 4 


May 8*10,1995 


Software Development 
East '94, Washington, D.C 
(415) 905-2414 

ColoradOS/2, 

Colorado Springs, Colo. 
(719) 576-5003 

OS/2 Development '95 
Amsterdam, Holland 
Phone: 32-3-358-6064 
Internet: csp@mfi.com 

71673 1163 
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includes an analysis and reporting tool 
and a source migration tool. The first sizes 
a conversion effort and provides a road 
map for the migration, thereby minimiz¬ 
ing work effort. The second changes up to 
70 percent of the API and message code 
and provides reports to help programmers 
migrate the remainder of the code. 

One Up Corp. Circle No. 152 

Phone: (214) 620-1123, Fax: (214) 620-9626 

Object COBOL Option. An add-on to the 
Micro Focus COBOL Workbench 3.2, this 
product provides developers with a com¬ 
prehensive object-oriented development 
environment and class library and enables 
the development of graphical user inter¬ 
face applications using Object COBOL. 
The option allows application developers 
to migrate existing code to object orienta¬ 
tion incrementally because it allows object 


and procedural code to coexist and coop¬ 
erate. Because Object COBOL syntax is 
processed by the COBOL compiler (not the 
preprocessor), the Micro Focus Object 
COBOL Option debugs code at the source 
level to increase programmer efficiency 
and reduce error. 

Micro Focus Circle No. 153 

Phone: (415) 856-4161 

NDP OS/2 Developer's Pack. Microway is 
now shipping four compilers for OS/2: 
NDP Fortran-77, NDP Fortran-90, NDP 
C\C++, and NDP Pascal. These products 
take advantage of the advanced features 
of the Intel 386/486 architecture along 
with OS/2's ability to load and run 32-bit 
applications on the 386, 486, and i860. 
Mainframe libraries like NAG, IMSL, and 
Kuck are also available for the NDP OS/2 
compilers; the compilers include MGX, 


Microway's device-independent, vector- 
based graphics and plotting package. 

Micro way Circle No. 154 

Phone: (508) 746-7341, Fax: (508) 746-4678 

PCYACC 4.0. This language development 
environment generates ANSI C source 
code from input language description 
grammars for building assemblers, com¬ 
pilers, interpreters, browsers, page-de¬ 
scription languages, language translators, 
syntax-directed editors, language valida¬ 
tors, natural language processors, expert 
system shells, and query languages. It 
includes 32-bit extended memory support 
for OS/2 2.0 that will compile any size 
grammar, debugging tools, and new C++ 
and YACC classes for OS/2 2.0 PM. 

Abraxas Software Circle No. 155 

Phone: (503) 244-5253, Fax: (503) 244-8375 


Multiple protocols. 
One slot. 



Use Quadron software to save PC expansion slot 
space and money by running two or more protocols 
on a single co-processor card. Each port can have 
a different protocol and line speed. 

Async • Bisync • HDLC/SDLC 
X.25 • LAP-B • Custom protocols 

We currently support OS/2, DOS, UNIX and AIX. 
With little or no modification, you can port your 
applications from one to another. Call today to find 
out how we can help you communicate better. 


« Quadron 805 - 966-6424 

^ 209 East Victoria Street, Santa Barbara, CA 93101 
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Wed like to dispel a couple of 
myths about client/server testing. 


Myth # I; Client/Server testing is easy. 

New development tools make building client/ 
server applications easier than ever. The problem 
is, they're harder to test, and you just can't stand 
up to them with manual testing methods. You 
need ATF, the only testing product designed for 
client/server. 

A^jtb # 2: Client/Server testing is impossible. 

Testing client/server applications can be daunting. 
The problem is, your tests need to replicate real- 
world conditions, and you just can't do that with a 
stand-alone testing product. You need ATF, the 
only testing product designed for client/server. 

The Softbridge Automated Test Facility's unique 
architecture makes it the only product for true 
client/server testing of OS/2 and Windows apps. 

To learn more about ATF, call 617-576-2257 
(Or FAX 617-864-7747.) 

If you're coming to OS/2 World in Santa Clara 
this July, stop by Booth 615 for an ATF demo. 

There's only one way to test client/server 
applications, and that's with ATF. 

- ^^^^|££f225L^l£L^ nl * ?r ' c * BePar * <Dr ' ve * Cambridge, MA 02140 
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CLIENT/SERVER SURVIVAL GUIDE WITH 
OS/2 2.1 by Robert Qrfali and Dan Harkey , 

A sweeping tour of client/server systems and 
software $39.95 0443-01798-7 IBM# SR28-5494 

CLIENT/SERVER PROGRAMMING KITH 
OS/2 2J S 3rd Ed. , by Robert Qrfali and 
Daniel Harkey . "Absolutely one of the most 
impressive, useful t best-written computer 
books I've ever seen, - Will Zachman, 

$39.95 04424/1833-9 IBM# QSSHffim 

THE GUI-OOUI WAR: Windows vs. OS/2 

by Theo S. Mandel U A book that should be 
forced on every Windows and OS/2 developer 
working today. An exceptionally clear ; read¬ 
able guide. If you want to make a good 
program great , theres no better starting 
place. - OS/2 Professional 

$29.95 0442-01750-2 IBM # SR28-5251 

OS/2 FUNCTIONS QUICK REFERENCE 
LIBRARY 1: Win Functions by Nora 
Schoiin. $19.950442-018974 

C AND C++ PROGRAMMING IN THE OS/2 
ENVIRONMENT by Mitra Gopaui $39.95 
0442-012403 IBM # SR284404 

OS/2 2J APPLICATION PROGRAMMER’S 
GLIDE by Jody Kelly , Craig Swearingen, 
Dawn Bezviner and Theodore Shrader. 

$34.95 0442-01736-7 IBM * SR28-5449 

OS/2 2.1 REXX HANDBOOK ; Basics, 
Applications, and Tips by Mallet German. 

A great reference book that, contains info 
not found in any other REXX books. 

$29.95 0442-0173441 IBM # SR-5250 


THE OS/2 2.1 CORPORATE PROGRAM¬ 
MER'S HANDBOOK by Nora Schoiin, Mark 
Sulliva n, and Robin Scragg. *A solid job. 
Introduces readers to programming terms 
and concepts. Explanations are lucid and 
reading relevant sections provides you with 
the basics you need. '-08/2 Professional. 
Includes disk, $39.95 0442-015984 
IBM# SR284390 

WRITING OS/2 2.1 DEIICE DRIVERS IN C } 
2nd Ed., by Steven Mastrianni “Should give 
any C programmer with a vague knowledge 
of 082 and PC hardware a headstart in unit¬ 
ing 082 device drivers in C '-International 
08$ User Group Magazine. Includes disk. 
$39.95 0442-017294 IBM# SR284392 

THE SHELL COLLECTION: OS/2 2Ji 
Utilities by Steven Levensm . A great source 
of shortcuts, tips and productivity boosters 
for Windows and DOS. Includes disk. 

$29.95 0442-01585-2 IBM # 0362-0049 

USING WORKPLACE OS/2: Power User's 
Guide to IBM OS/2 Version 2J by Lori 
Brown and Jeff Howard. The authors are the 
principal designers of the Workplace Shell! 
Includes disk. $24.95 0442-01590-9 
IBM# SR284391 

THE OS/2 2M HANDBOOK: Applications, 
Integration, and Optimization by William 
H lack, J 'Should be within fingertip reach of 
anyone working with OS/2. IBM would do 
well to include a copy in every package of 
OS/2. Professional $34.95 0442-01234-9 
IBM # G362-0009 

os/sl® is a regisMwl frail pm nr* uf iJm- IBM Cwpwirtion, 


OS/2 2JC NOTEBOOK: me Best of IBM 
OS/2 Developer, edited by Dick Conklin. 
$36.95 0442-015224 IBM # GS62-00I5 


MOW THAT I HAW OS/2 2.1 ON MY 
COMPUTER, WHAT DO / DO NEXT?, 2/E. 

by Steven Levenson. “Easy to read, loaded 
with examples, a friendly reference source." 
-Journal of The Chicago Computing Society, 
$22.95 0442-01832-0 IBM # G362-000&01 


COMPREHENSDE DATABASE PERFOR¬ 
MANCE FOR OS/2 2.0’s Extended Services 

by Bruce Tate, Tim Malkemus and Terry 
Gray. $41.95 0442-013254 IBMtt G362-0019 


LEARNING TO PROGRAM OS/2 2.0 
PRESENTATION MANAGER BY EXAMPLE: 
Putting the Pieces Together 

by Stephen Knight. Includes disk. 

$41.95 0442-01292-6 IBM # G362-0011 


THE COBOL PRESENTATION MANAGER 
PROGRAMMING GUIDE by David M. Dill. 
$41.95 0442-012934 IBMft G362-0010 


OS/2 PRESENTATION MANAGER GP1 
GRAPHICS by Graham C. E. Winn $42.95 
0442-00739-6 HIMH 0362-0005 


Order directly from 
the publisher by call¬ 
ing 1-800-544-0550. 
Tn order from IBM 
call 1-800-568-2694 
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POWER UP WITH 

THE RIMSTAR PROGRAMMER’S EDITOR 

NEW VERSION 2.1 



If you’re looking for a fully configurable, professional OS/2 PM 
programmer’s editor to replace your current text-mode editor - we 
have what you have been looking fori 

No hassle changing editors 

We know changing editors can be a major hassle You don't want 
to relearn a new set of keystrokes no matter how good the product, 
Well, you don't have to - we have Brief CUA Epsilon, Mufti—Edit, 
SlIckEdlt, PWB, and Borland IDE keyboard mapping waiting for you. If 
you're not using one of these, let us know and we will create the 
mappings you need. 

Features designed to increase productivity 
It has all the features you have come to expect plus special 
features designed to anticipate your needs and Increase your 
productivity. Features like a 'C' source browser that eliminates those 
time consuming searches for functions global variables, typedefs, 
and macros by providing you with instant positioning to both 
definitions and references Using our powerful 'C macro language 
you can customize your programming environment to suit your 
Individual needs, 


Partial Feature List 

✓ Complete ANSI ‘C’ macro language 

✓ SyntaC olor—syntax highlighting 

✓ Smart C/C++ Indenting & brace matching 

✓ Bookmarks 

✓ Unlimited undo and redo 

✓ Timed auto save 

✓ Access PDK help for function under cursor 

✓ Multi-threaded for no waiting 

✓ Compile and jump to errors 

✓ Import/export to system clipboard 

✓ Keystroke record/playback 

✓ Block indent/outdent 

✓ Hex editing 

✓ Customizable menus 

✓ Column, line and block 
selection, search and replace 

✓ integrates with Workframe/2 

✓ Source browser for ‘C' 

✓ Template editing 

✓ Multi-buffer regular expression 
search and replace 

✓ Support for version control 

✓ Complete on-line help 

✓ Save and restore state between sessions 

✓ OS/2 2.x 32 bit PM Multi-document 
Interface 


•My copy of Brief has been permanently 
retired. Keep up the good workl* • A.L 


RlmStar Technology, Inc. 

91 Halls Mill Road 
Newfields, NH 03856 
Voice: (603) 778-2500 
Fox: (603) 778-2408 
BBS: (603) 778-4644 


Price $299.00 

Plus Shipping & Handling, 

To order call 1 -800-746-7007 

60 day money-back guarantee, 

Aiso available for Windows and Windows NT 


Al products and company names ore 
tadamate o* registered trademarks of their 
respective nokdecs. RlmStar and SyntoColof 
are trademarks of RlmStar Technology, Inc, 


© 1994 RlmStar Technology Inc. 
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The Borland Report on preventing application failure 


Borland is first to deliver 
“Just-in-Time” debugging 



The Fastest Way to Find and Fix Bugs 

You’re running your program. You hit an edge condition. You 
crash. Unexpected? Of course. Chances are you weren’t running 
your debugger. What happens next? It depends upon the tools you 
use. If you’re using Borland* C++, Turbo Debugger will automati¬ 
cally launch and take you to your problem. If you’re using any other 
C++* you may be in for a long ride home. 

Only Borland has Just-in-Time Debugging 

The Turbo Debugger, in Borland C++, is now better than ever. Now 
you can debug your application even if the debugger isn’t running, 
A hot new Borland technology in the Turbo Debugger called "Just- 
in-Time Debugging" makes it possible. With Just-in-Time 
Debugging, if you run into a fault under NT or Chicago, Turbo 
Debugger will automatically load and take you directly to the 
offending piece of code. That means you can 
debug your program even if you hadn't already 
started the debugger. You catch and fix bugs 
faster...you ship sooner with Borland C++, 


Buy Borland C++ 
ST. FREE 
Training Course 


Borland 

The Upsizing Company 


Only Borland has Exception Handling and RTTI 

Of course preventing bugs is better than fixing them* That’s why 
Borland is at the forefront in delivering new language features that 
not only save you time in debugging, they can actually save your 
project. Features like runtime type information prevent improper 
casts that can easily cause your program to exhibit unpredictable 
behavior. And exception handling which lets you recover cleanly 
from crashes that otherwise would leave objects on the stack-or 
even worse, leave your customer's data in unstable states. 


Get Borland C++ 

For years, Borland’s Turbo Debugger has been 
saving development projects. With conditional 
breakpoints, expression evaluation, remote 
capabilities, exception handling support, and 

now, Just-in-Time Debugging and DPMI 
support. Buy Borland C++ today and put Just-in- 
Time Debugging to work for you. For more 

information call: 1-800-645-4559, ext. 8842 


Subscribe Now to Our Free Technical Newsletter: Send Mail to tech-infa@borland.com 


Copyright © 1994 Borland Internetmrud. inc, All rights reserved. All Borland product names are innk-niariis of Borland International, Inc. Bi 7380,1 
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